superwhisper 在 Mac 上用不了:每种现象意味着什么,以及怎么解决
作者 Ryleigh Newman · 发布于
superwhisper 在 Mac 上停止工作,原因通常是五件事之一。第一是辅助功能权限,它需要这项权限才能粘贴到其他 App。第二是麦克风选错了,表现为 No voice found(没有检测到语音)。第三是某个快捷键已被另一个 App 占用。第四是某个模型还在下载,或者需要网络连接。第五是 Mac 还停留在 macOS 13,因为当前版本需要 macOS 14。修复期间,你说的话通常是安全的:superwhisper 说它会在你说话的同时保存每一次听写,所以之后可以在 History(历史记录)里重新处理。
我做的是 YapToText,另一款 Mac 听写 App,它只在靠近结尾的地方出现一次。这里关于 superwhisper 的一切,都来自它自己的故障排查文档,我在2026年10月6日读过,每一页都链接在“资料来源”里。我自己没有重现过这些问题,所以这些步骤是 superwhisper 的,只是用我的话写出来。
免费下载。无需账号,没有锁定的功能。需要搭载 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, 繁體中文
步骤
- 如果提示 <span lang="en">No voice found</span>,检查当前的麦克风和麦克风权限。
- 如果什么都不粘贴,打开辅助功能。
- 如果快捷键没反应,在 <span lang="en">Settings</span>,<span lang="en">Configuration</span> 里重置它。
- 修好之后,从 <span lang="en">History</span> 里重新处理这次听写。
对照你看到的现象找解决办法
出自 superwhisper 的故障排查文档,2026年10月6日查阅。在重现问题之前,先在 Settings,Configuration 里打开 Error logging(错误日志),这样任何报告都会有用。
| 你看到的现象 | 可能的原因 | 先试这个 |
|---|---|---|
| No voice found | 没有语音传到 App:麦克风选错或被静音,或者没有权限 | 检查任意设置面板右上角的输入设备,以及麦克风权限 |
| 一直卡在处理中 | 云端模型没有网络连接,或者本地模型还在下载 | 检查网络连接和 Settings,Models library,然后在 History 里重试 |
| 文字停在 History 里,一直不粘贴 | 辅助功能权限 | 在“隐私与安全”,“辅助功能”里打开 superwhisper |
| 粘贴出来的是旧的剪贴板文字 | Keep what I have copied 对有些 App 过早恢复了你的剪贴板 | 把 Clipboard content 设为 Replace with dictation |
| 得到的是原始文字,而不是整理后的文字 | AI 这一步失败了,通常是因为离线 | 重新联网,或者把这个模式切换到本地语言模型,然后重新处理 |
| 快捷键没反应 | 别的 App 或 macOS 占用了这个键 | 试一个不常用的组合,再到“键盘快捷键”里检查有没有冲突 |
| 打不开 | macOS 版本低于 14 | 更新 macOS,或者安装 2.16.1,也就是适用于 macOS 13.3 的最后一个版本 |
| 听写过程中崩溃 | 本地模型内存不足,或者磁盘已满 | 先更新,再试云端模型或较小的模型,并腾出一些磁盘空间 |
先解决原因,再从 History 里重新处理这次听写,而不是再说一遍。
如果提示 No voice found,或者卡在处理中
superwhisper 说,No voice found 的意思是录音里没有检测到语音,问题几乎总是出在输入上,而不是模型。在换模型之前,先弄清有没有声音传到 App。
- 检查当前的麦克风。它显示在每个设置面板的右上角。点击它可以切换,也可以选 Use system default(使用系统默认)。
- 检查权限。“系统设置”,“隐私与安全”,“麦克风”,把 superwhisper 打开。
- 看波形。开始录音并说话。如果波形不动,就没有音频进来。试试内置麦克风,排除蓝牙设备的问题。录制系统音频的模式,会故意让波形保持不动。
- 回放录音。在 History 里打开它。如果是静音,说明输入选错了或被静音了。如果语音清晰却仍有这个错误,值得从 History 里报告。
- 让它自动调高音量。Settings,Sound 里的 Automatically increase microphone volume,会在录音开始时把输入音量设为最大,前提是 superwhisper 用的是系统默认设备。
如果听写是卡在处理中,superwhisper 给出的清单是这样的。检查网络连接,因为云端模型需要联网。检查本地模型是否已经下载完成,位置在 Settings,Models library。重启后到 History 里重试,音频已经保存在那里了。
如果什么都粘贴不出来,或者粘贴出错误的文字
听写出现在 History 里,却没有出现在你的 App 里,说明转写没问题,只是送达失败了。按 superwhisper 的说法,辅助功能是最常见的原因。
- 授予辅助功能。“系统设置”,“隐私与安全”,“辅助功能”,把 superwhisper 打开。它需要这项权限才能粘贴到其他 App。
- 让光标留在原处。superwhisper 粘贴到当前光标的位置,所以在它处理期间点到别处,粘贴就无处可去了。文字仍然在剪贴板上。
- 阻止粘贴的 App。安全输入框、有些终端和虚拟机会拒绝模拟的粘贴。高级设置里的 Simulate keypresses(模拟按键)会把结果一个键一个键地敲进去。superwhisper 说它是实验性的,而且只支持美式 QWERTY 键盘。
- 旧的剪贴板文字。把 Clipboard content 设为默认的 Keep what I have copied 时,速度慢的 App 可能会读回你旧的剪贴板内容。请改选 Replace with dictation。
- 粘贴了两次。通常是 Simulate keypresses 加上一个同样接受粘贴的 App,或者处理期间把快捷键按了两次。
如果快捷键没反应
superwhisper 有两种快捷键,把它们混在一起,是它见得最多的原因。全局快捷键在 Settings,Configuration 里,每个模式还可以有自己的快捷键。
- 别的 App 占用了这个键。全局快捷键会输给系统和 App 的快捷键。试一个不常用的组合来确认,然后选一个没有别的功能在用的键。
- 单个修饰键。Command 或 Fn 可以单独使用,但 superwhisper 指出,有些键盘会把 Fn 发给系统而不是 App。请测试一个普通的组合。
- 录音窗口设成了 None。录音仍然在进行,但屏幕上什么也不显示。听写一句,然后到 History 里看看。
- 重置它。清除这个快捷键,在 Settings,Configuration 里重新录制,然后退出并重新打开 superwhisper。
- 找一找冲突。“系统设置”,“键盘”,“键盘快捷键”,看有没有同样的组合。
如果某个键启动了错误的模式,很可能是同一个键既被设成了全局快捷键,又被设成了某个模式自己的快捷键。请让它们各用各的键。
如果打不开,或者崩溃
这里有两个看起来相似的问题:App 拒绝打开,以及 App 在听写中途退出。先检查 macOS 的版本:当前的 superwhisper 版本需要 macOS 14 或更高版本。
- 在 macOS 13 上。superwhisper 的文档说,2.16.1 是适用于 macOS 13.3 的最后一个版本,它和更早的版本一起列在 superwhisper.com/appcast.xml。它的下载页面在2026年10月6日仍然写着 13.3。
- 覆盖重装。从 superwhisper.com 重新下载,拖到“应用程序”里。你的设置存放在 Superwhisper 文件夹里,而不是 App 里,所以替换 App 是安全的。
- 重启 Mac,再试一次。如果它在启动时崩溃,superwhisper 请你发一封邮件,附上你的 macOS 版本和崩溃报告。
对于听写过程中或之后的崩溃,superwhisper 说音频在你录音时就已经写入磁盘,所以听写通常还在 History 里等着。它的步骤是这样的。从 Settings,Configuration 里更新。如果在用本地模型,就把这个模式切换到云端模型,或者换成较小的模型,比如 Whisper Base,因为崩溃就此消失,说明 Mac 的内存不够用了。再试一下最基本的 Voice to Text 模式,并腾出一些磁盘空间。
如果很慢,或者输入了错误的语言
superwhisper 点出了听写变慢背后的四个因素:你 Mac 的资源、网络连接、模型,以及是否运行了 AI 处理。你选的模型,以及它保持加载的时间,通常影响最大。
- Voice model active duration。在 Settings,Advanced settings 的 Voice model 下,从 10 秒到 1 小时。时间短能释放内存,但每次都要重新加载模型。
- 较小的模型或云端模型。Whisper Base,或者像 S1-Voice 这样的云端模型,可以减轻 Mac 的负担。
- 跳过 AI 这一步。Voice to Text 模式不经过 AI 处理,直接转写。
- 输出了英语,而不是你的语言。语言设为 Automatic 时,superwhisper 说非英语的语音有时会变成英语输出。请把这个模式的语言设成你的语言,或者把它建议的提示短语用你的语言加到 Vocabulary 里。
如果你得到的是原始的、没有格式的文字,而这个模式本应整理它,说明 AI 这一步失败了。superwhisper 指出,即使语音模型是本地的,大多数语言模型也在云端运行,所以请重新联网,或者把这个模式的语言模型切换成本地的,比如 S1-mini,然后在 History 里重新处理。
YapToText 适合的地方
superwhisper 和 YapToText 是近亲:两者都在你的 Mac 上运行 Whisper。这里要紧的区别是,YapToText 的文字整理也在 Mac 上运行,免费,不需要先下载任何东西。
两个模型都内置在 YapToText 的 App Store 版本里,所以不用等模型下载,也没有离线时会失效的云端语言模型。它只有 Mac 版,需要 Apple 芯片和 macOS 14,没有 Windows 或手机版 App。superwhisper 替代方案那一页列出了 superwhisper 能做、而它做不到的事。

小结
- No voice found。检查输入设备和麦克风权限,然后在 History 里回放录音。
- 什么都不粘贴。打开辅助功能,并让光标留在原处。
- 快捷键失灵。别的 App 占用了这个键。在 Settings,Configuration 里重置它。
- 打不开。当前版本需要 macOS 14。2.16.1 是适用于 macOS 13.3 的最后一个版本。
- 崩溃。先更新,再试云端模型或较小的模型。
- 原始文字。AI 这一步失败了:重新联网或选一个本地语言模型,然后重新处理。
修好之后,从 History 里重新处理。superwhisper 会保留音频。如果这里有什么和 superwhisper 的文档不一致了,请在 GitHub 上告诉我。
免费下载。无需账号,没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
指南
资料来源
- https://superwhisper.com/docs/common-issues/troubleshooting (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/no-voice-found (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/llm-processing-error (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/app-wont-launch (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/crashes (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/pasting-issues (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/shortcuts-not-working (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/microphone-and-system-audio (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/performance-tips (查阅于 2026年10月6日)
- https://superwhisper.com/docs/common-issues/language-detection (查阅于 2026年10月6日)
- https://superwhisper.com/download (查阅于 2026年10月6日)
- https://github.com/ryleighnewman/YapToText (查阅于 2026年10月6日)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (查阅于 2026年10月6日)
常见问题
为什么 superwhisper 在我的 Mac 上用不了?
最常见的是缺少辅助功能权限,它需要这项权限才能粘贴。其次是麦克风选错了,表现为 No voice found。再就是某个快捷键被别的 App 占用,某个模型还在下载或需要网络连接,或者是 macOS 13,因为当前版本需要 macOS 14。
为什么 superwhisper 提示 No voice found?
superwhisper 说,这表示录音里没有检测到语音,几乎总是输入的问题:麦克风选错或被静音,或者没有麦克风权限。请检查任意设置面板右上角的输入设备,并在 History 里回放录音。
为什么 superwhisper 不粘贴?
通常是辅助功能权限,superwhisper 称之为最常见的原因。另外,处理期间要让光标留在目标输入框里,对于阻止粘贴的 App,可以试试 Simulate keypresses。文字仍然在 History 里,也在剪贴板上。
为什么 superwhisper 打不开?
当前版本需要 macOS 14 或更高版本。superwhisper 的文档把 2.16.1 列为适用于 macOS 13.3 的最后一个版本。除此之外,请重新下载,拖到“应用程序”里,再重启 Mac。
为什么我的 superwhisper 快捷键没反应?
很可能是别的 App 或 macOS 占用了这个键,因为全局快捷键会输给系统和 App 的快捷键。试一个不常用的组合,在 Settings、Configuration 里重置快捷键,并到“系统设置”,“键盘”,“键盘快捷键”里检查有没有冲突。
superwhisper 能在 macOS 13 上用吗?
只有旧版本可以。superwhisper 的故障排查文档说,当前版本要求 macOS 14 或更高版本,2.16.1 是适用于 macOS 13.3 的最后一个版本,这是我在2026年10月6日读到的。