VoiceInk 没反应：它自己的文档给出的解决办法，按顺序排查

作者 · 发布于

VoiceInk 不工作时，它的文档说，原因几乎总是这五项之一：缺少某项 macOS 权限、麦克风选错了、某个 Mode 用了你没想到的设置、本地模型对这台 Mac 来说太慢，或者你正在输入的 App 里粘贴的时机不对。请按这个顺序检查。大多数问题一分钟就能解决。

我做的 YapToText 是另一款听写 App，我自己没有用过 VoiceInk。下面每一个步骤都来自 VoiceInk 的文档，我在 2026年10月9日查阅。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

用其他语言阅读： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文

步骤

  1. 在“系统设置”里检查“麦克风”和“辅助功能”权限，然后重启 VoiceInk。
  2. 在 VoiceInk 的 <span lang="en">Audio</span> 视图里选对麦克风。
  3. 检查当前的 Mode 有模型、语言正确，而且输出方式是 <span lang="en">Paste</span>。
  4. 如果粘贴出旧文字，在 <span lang="en">Settings</span>，<span lang="en">Pasting</span> 里调高 <span lang="en">Restore Delay</span>。

能录音，但没有文字出现

  • 权限。 在“系统设置”的“隐私与安全”里，VoiceInk 需要“麦克风”权限才能录音，需要“辅助功能”权限才能粘贴。只有当某个 Mode 使用屏幕上下文时，Screen Recording 才有关系。任何更改之后都要重启 VoiceInk。
  • 麦克风。 打开 VoiceInk 边栏里的 Audio，选对设备或设定优先顺序，插入新麦克风之后点按 Refresh Microphones。在“系统设置”的“声音”，“输入”里，你说话时电平应该会跳动。
  • 当前的 Mode。 在 Modes 里，检查这个 Mode 已启用，有可用的转写模型，语言正确，而且输出方式是 Paste。Respond 和 Custom Command 是特意把文字送到别处的。
  • 模型。 在 AI Models 里，本地模型必须已经下载，云端服务商则需要一个可用的 API 密钥。

如果你在 History 里能看到文字，但在 App 里看不到，问题出在粘贴，而不是听不到。

能转写，但粘贴的内容不对或什么也没粘贴

VoiceInk 的粘贴方式是把文字放到剪贴板，再替你按下 Command V。文档按顺序给出了这些解决办法：

  • 先点进文本框。 粘贴会送到当前获得焦点的地方。
  • 出现了剪贴板里的旧文字。 在 Settings，Pasting 里，保持 Keep Clipboard Content 开启，并调高 Restore Delay。默认值是 2 秒，最高可以到 5 秒。
  • 你的剪贴板内容老是消失。 这是 Keep Clipboard Content 关闭了。把它打开。
  • 还是没有。 把 Paste Method 从 Default 切换为 AppleScript，文档也建议自定义键盘布局的用户这样做。

运行很慢

  • 换一个更快的本地模型。 文档建议用 Parakeet V3 或 V2 来做快速的本地听写，如果大型模型拖慢速度，就换小一点的 Whisper 模型。
  • Intel Mac。 本地模型通常在 Apple 芯片上运行得更好。在 Intel 上，文档建议使用云端转写服务商。
  • 转写很快，出结果很慢。 这是 AI 增强这一步造成的。对于普通听写的 Mode，把它关掉，或者打开 Skip short transcriptions。
  • 找出慢在哪一步。 Dashboard，View Insights，Model Performance 会比较各个模型，History，Analyze 会给每段录音计时。

重复的词、凭空出现的文字，或语言不对

  • Voice Activity Detection。 在 AI Models 里点齿轮按钮，进入 Transcription，把它打开。它能帮本地模型忽略静音。
  • 换一个模型。 试试 Parakeet，或者在较大的 Whisper 模型生成过多内容时，改用 Whisper Base 或 Tiny。
  • 重试。 更改设置之后，用 Settings，Shortcuts 里的 Retry Last Transcription 可以对同一段音频重新转写。
  • 语言总在变。 语言是按 Mode 设置的，而 Mode 可以按 App、网站或默认设置自动切换。检查一下当前启用的是哪个 Mode。

如果你想要今天就能用的东西

YapToText 是适用于 macOS 14 或更高版本的 Apple 芯片 Mac 的免费听写 App，可能出错的设置要少得多。它没有按 App 切换的 Mode，没有云端密钥，也没有需要调整的剪贴板延迟。

  • 一个键。 轻按 Right Command，说话，再轻按一下。文字就出现在光标处。
  • 两个模型都内置。 App Store 版本自带语音模型和整理文字的模型，所以不用先下载什么。
  • 选项更少。 它只有 Whisper 这一个语音模型系列，没有 VoiceInk 的 Assistant Mode、自定义命令和云端服务商。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

VoiceInk 替代方案页面对这两款做了比较，Mac 听写故障排查指南则讲 Apple 自带的听写。

小结

  • 没有文字。 检查“麦克风”和“辅助功能”权限、所选的麦克风，以及当前的 Mode。
  • 粘贴不对。 调高 Restore Delay，或者把 Paste Method 切换为 AppleScript。
  • 很慢。 用 Parakeet，在 Intel 上用云端，或者关掉 AI 增强。
  • 还是不行。 VoiceInk 的支持团队会要的是 Settings，Diagnostics，Export Logs。

如果 VoiceInk 的文档有变化，这里的某个步骤不再对应，请在 GitHub 上提交 issue。每一条我都会看。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

关于作者。 Ryleigh Newman 从事软件开发，用手打字有困难，每天都用本站介绍的 YapToText 听写。本页译自英文。App 的界面和网站的其他页面是英文的。 进一步了解这个项目（英文）。

指南

更多指南（英文）

资料来源

常见问题

VoiceInk 为什么不输入任何文字？

通常是缺少“辅助功能”权限、某个 Mode 的输出方式不是 Paste，或者焦点不在文本框里。它的文档说先检查这些，再检查麦克风和模型。

VoiceInk 为什么粘贴出我剪贴板里的旧内容？

是因为剪贴板在 App 粘贴完成之前就被恢复了。在 Settings，Pasting 里，保持 Keep Clipboard Content 开启，并把 Restore Delay 从默认的 2 秒调高。

VoiceInk 为什么这么慢？

通常是因为用了大型本地模型、用的是 Intel Mac，或者是 AI 增强这一步。它的文档建议本地用 Parakeet V3 或 V2，在 Intel 上用云端转写，普通听写则关掉增强。

VoiceInk 为什么老是切换语言？

语言是按 Mode 设置的，而 Mode 可以按 App、网站或默认设置自动切换。检查当前启用的 Mode，以及哪个 Mode 被标记为默认。

有没有比 VoiceInk 更简单的免费替代方案？

YapToText 在 macOS 14 或更高版本的 Apple 芯片 Mac 上免费，只有一个听写键，模型已经内置在 App Store 版本里。