教 Mac 听写新词：人名、行话、品牌

作者 · 发布于

要给 Mac 听写添加词汇，你需要一份词表，把语音模型听到的写法和你想要的写法配成一对。Apple 的听写在设置里没有这样的词表，所以在那里，你只能边听写边改词，试试 Text Replacements（文本替换），或者改用“语音控制”和它的自定义词汇。YapToText 是我做的免费听写 App，它有一个 Dictionaries 页面，专门做这件事，里面的一切都留在你的 Mac 上。

人名是最典型的例子，而我自己的名字就是我天天要面对的那个：麦克风听成 Riley，我的拼写是 Ryleigh。我做 YapToText，是因为我用手打字有困难，每天都要听写。下面先讲 Apple 提供什么，再讲怎样教 YapToText 一个人名、一个产品名和一个缩写，以及某个词仍然改不过来时该怎么办。

在 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. 在 YapToText 里打开 History，在一次这个词写错了的听写上点按 Show pipeline details。
  2. 记下原始转写文本里的写法。
  3. 在 Dictionaries 页面，把那个写法填进 Heard，把你的写法填进 Replace with。
  4. 保持 Whole word 打开、Case 关闭，然后按 Add。
  5. 再听写一次这个词，确认它按你的写法落了下来。

Apple 的听写让你改什么

Apple 在“键盘”设置里列出的听写设置，有开关、语言、麦克风来源、快捷键和自动标点符号。其中没有一项是词表。Apple 的听写没有添加词汇的地方，所以只能绕着走。绕开的办法有三种：

  • 边听写边改词。 听写会用蓝色下划线标出它不确定的词。点按其中一个，选择替代项，或者键入或听写正确的词。这样改的是页面上的这个词，而不是下一次。
  • Text Replacements（文本替换）。 选取苹果菜单，“系统设置”，点按边栏中的“键盘”，再点按 Text Replacements。点按 Add 按钮，键入要替换的文本和它的替换内容，然后点按 Add。Apple 把它们描述为许多 Mac App 里的自动替换，比如把 teh 换成 the。它的页面没有说这些替换会不会对听写的文字生效，所以依赖之前，请先在你自己的 App 里试一试。Apple 明确写出的，是把它们用在已有的文本上：选中文本，选取“编辑”，然后选 Substitutions, Show Substitutions，确认选中了 Text Replacement，再点按 Replace in Selection。
  • “语音控制”的词汇。 “语音控制”是 Apple 另一项无障碍功能，它有自定义词汇。Apple 说，在“系统设置”的“无障碍”，“语音控制”里最多可以添加 1,000 个词条，录下你怎样说每一个词，也可以对选中的词说 Add to vocabulary 来添加，限支持自定义词汇的语言。问题在于：“语音控制”打开时，标准听写不可用，你要通过“语音控制”来听写。“语音控制”与听写的对比指南 权衡了这个取舍。

如果问题不是一个词，而是很多词，原因通常是麦克风、房间或语言设置，而不是你的词汇。提高听写准确度的指南 把这些办法按效果从大到小排了序。

三步教 YapToText 一个词

YapToText 的 Dictionaries 页面里是一个个条目，每个条目都在说：听到这个，就写成那个。一个条目从此对每次听写都生效。在 Heard 里填语音模型听到的写法，而不是你本来想说的。

第 1 步：找出 Whisper 实际听到了什么

  • 操作： 打开 History，找到一次这个词写错了的听写，点按 Show pipeline details。
  • YapToText： 显示原始转写文本，也就是语音模型在任何修正之前听到的内容。
  • 确认： 你能看到准确的错误写法，比如 riley。
YapToText 的一条 History 记录，展开了处理流程详情：原始转写文本、整理后的文本、模式、输入方式、目标 App 和耗时。
图1. 原始转写文本在整理后的文字上方。该填进 Heard 的是它的写法，而不是你的写法。

第 2 步：添加条目

  • 操作： 在 Dictionaries 页面，在 General 之类的词典里，把错误的写法填进 Heard，把你的写法填进 Replace with，然后按 Add。
  • YapToText： 保存它，从你的下一次听写起就会用上。
  • 确认： 条目出现了，带有一个 word 标签，表示 Whole word 已打开。

第 3 步：听写这个词

  • 操作： 轻按 Right Command，说一句含有这个词的话，再轻按一次。
  • YapToText： 听的时候心里有你的写法，然后应用这个条目。
  • 确认： 这个词按你的写法落了下来。

这个条目会起两次作用。自 1.2 版起，在 Whisper 解码你的音频之前，YapToText 会根据条目里 Replace with 一侧建立一份简短的词表，作为提示交给 Whisper，让它倾向于你的写法。然后替换会作为保险再运行一次，既作用于原始转写文本，也作用于任何 AI 整理之后，所以整理不会撤销一次修正。OpenAI 的 Whisper 提示指南说，Whisper 可能会写错不常见的专有名词，比如产品、公司或人的名字。这正是词典要补上的缺口。

三个例子：人名、产品名、缩写

第一个例子是我的，直接来自我自己的词典。另外两个是编出来演示做法的。请用你自己的原始转写文本里的写法。做法就是每种听错的情况一个条目，从 History 里照抄。

一个人名

词典条目： 我的名字，麦克风怎么听，我怎么拼。

Heard: riley
Replace with: Ryleigh

会发生什么： 听写里的每个 riley 都会写成 Ryleigh，而 Ryleigh 也会作为要留意的词交给 Whisper。Case 默认是关闭的，所以 Riley 和 RILEY 也能匹配。

一个产品名

假设你们团队的产品叫 Larkspan，而原始转写文本里总是出现两个词。

词典条目： 一个编出来的产品名，被语音模型拆成了两个词。

Heard: lark span
Replace with: Larkspan

会发生什么： 这两个词变成你的一个词的产品名，而 Larkspan 加入了给 Whisper 做提示的词表。词典不仅能改单个词，也能改短语。

有些品牌在你开始之前就已经覆盖了。刚安装的 App 里有几个语音模型一贯会听错的条目：iPhone、iPad、iMac、AirPods、macOS、YouTube、Wi-Fi，以及这款 App 自己的名字。它们只会在你没有自己的条目时才添加。

一个缩写

假设你整天都在谈 OKRs，而原始转写文本里出现的是类似 okay ours 的东西。

词典条目： 一个编出来的缩写听错的例子。

Heard: okay ours
Replace with: OKRs

会发生什么： 这个短语变成 OKRs。因为 Whole word 是打开的，这个条目只在这个短语单独出现时才会生效。

Heard 请选一个你绝不会真的说出口的写法，因为条目每次匹配都会生效。缩写和 Intelligent Insert 也配合得很好：当你听写到一个句子中间时，第二个字母也是大写的词会保持大写。三种情况还适用同一条长度规则：Replace with 只有一个字符，或者超过 40 个字符，就不会用来给 Whisper 做提示，不过替换仍然会处理它。

Whole word、Case、顺序，以及多个词典

大多数条目只需要 Heard 和 Replace with。这些选项是为不够用的情况准备的。除非有理由，请保持 Whole word 打开、Case 关闭。

  • Whole word（默认打开）。 Heard 只在单独出现时才会匹配，所以 cat 的条目不会碰 catalog。关闭它，也可以匹配较长的词里面的部分，适合前缀或片段。
  • Case（默认关闭）。 iphone、Iphone 和 IPHONE 都能匹配。打开它，则只匹配 Heard 里的那种确切的大小写。Case 打开时，这一行会显示 Aa 标签。
  • 顺序。 条目从上到下运行，所以两个条目碰到同样的词时，位置高的先运行。拖动一行开头的手柄，就能移动它。
  • 文件夹。 通向同一个词的几种写法会折叠成一行，比如 Ryleigh, 3 spellings。展开它，可以添加或移除写法。

你可以有不止一个词典。从 General 开始，按 New Dictionary 新建其他的，比如 Work。每个词典都有自己的开关，所以你可以暂停一整套词典而不用删除任何东西，它的菜单里有 Export Dictionary、Show in Finder 和 Delete Dictionary。在任何一个 听写模式 的编辑器里，Dictionaries 卡片都有 Use every dictionary that's turned on，默认是打开的。关闭它，就能精确选择那个模式运行哪些词典。所有词典都保存在你 Mac 上 App 自己的容器里的一个文件 vocabulary.json 中，不会被任何东西同步。Settings, Advanced, Backup & sharing 里的 Export Preset，会把你的词典连同模式和设置一起带到另一台 Mac 上。

不用打开 Dictionaries 页面也能添加词

手动键入条目是比较慢的办法。你可以在任何 App 里，用语音教它一种写法。

说： 在任何地方选中正确的写法，轻按 Quick Edit 键之后，默认是 Right Option。

add this to my dictionary

会发生什么： 卡片显示 Added，词放在引号里。它会原样加入你的第一个词典。如果是三个字母或更长的单个词，App 还会映射识别器容易听成的拆分，比如把 you tube 映射到 YouTube，以及整理模型给出的最多四种可能的听错写法。如果这个词已经在里面，它会这么告诉你。

Quick Edit 的聆听卡片，写着：Listening for your edit，下面是说出的指令。
图2. Quick Edit 卡片正在聆听。对着选中的词说 add this to my dictionary，卡片就会显示 Added。
  • 来自一次更正。 一次听写刚落下来之后，说 replace，然后是错误的词，再说 with，然后是正确的词。同一种听错如果更正了两次，Home 页面就会显示“Make this correction stick?”，点 Add it，就会把这个修正放进名为 Learned 的词典，同样用来给 Whisper 做提示。只有不超过三个词的修正才会被学习。
  • 来自一个条目。 在任何一行或文件夹上用 Generate variations，会让你 Mac 上的模型给出那个词可能听错的写法，并把它们映射到它上面。复数、截断的词和真正的词会被过滤掉。
  • 来自你的历史记录。 打开 Suggest fixes from my dictations（默认打开）后，App 会翻看最近最多 400 次听写，找出它总要重新改大小写的词。一个出现至少三次的修正，会连同次数显示在 Suggested for you 下，一次最多八个。加号按钮会添加它，x 按钮表示以后再也不建议它。在你说可以之前，不会添加任何内容。
YapToText 的 Dictionaries 页面：建议的修正，比如把 thursday 改成 Thursday，以及包含 iPhone 和 Wi-Fi 的 General 词典。
图3. Suggested for you 列出了在你自己的听写里反复出现的修正，每个都带着次数。它下面的 General 词典，把听到的写法和你想要的写法配成一对。

比较 Apple 的选项和 YapToText

2026年10月5日，依据 Apple 的支持页面，并对照 YapToText 自己的帮助页面核对。

Apple 听写语音控制YapToText
在哪里“系统设置”，“键盘”，“听写”“系统设置”，“无障碍”，“语音控制”Dictionaries 页面
词表设置里没有自定义词汇，最多 1,000 个词条带 Heard 和 Replace with 的条目，放在一个或多个词典里
用语音添加选中的词不可以说 Add to vocabularyQuick Edit，然后说 add this to my dictionary
改页面上的一个词点按蓝色下划线，选一个替代项这里没有比较说 replace，接着说错误的词，再说 with 和正确的词
能否与标准听写并用它本身就是标准听写不能，它打开时标准听写是关闭的用自己的语音模型，不使用 Apple 的听写

Text Replacements 不在这张表里，因为 Apple 记录它们针对的是一般文本，而不是听写。如果你想继续用 Apple 的听写，就试试 Text Replacements。如果你想要一份真正的词表，“语音控制”或 YapToText 都有。 YapToText 可以在 Mac App Store 免费下载。

每种办法做不到的事

  • Apple 听写。 设置里没有词表，蓝色下划线的修正只改页面，不改下一次听写。Apple 的 Text Replacements 页面没有说它们适用于听写的文字。
  • 语音控制。 它打开时标准听写不可用，而且自定义词汇只在支持它的语言里有效。
  • YapToText，确切的写法。 Heard 必须与 Whisper 写出的内容一致。如果它在不同的日子听成不同的写法，就把每种写法都加上，或者按 Generate variations。
  • YapToText，提示的额度。 大约 200 个字符。你的词典术语排在最前面，然后是你最近听写里有特点的词，所以很长的词典不会全部放得下。不过替换仍会对每个条目运行。
  • YapToText，改的是词而不是语法。 词典改的是词和短语。用语音输入标点，是 口述命令 的事。
  • YapToText，开头的人名。 如果一个人名出现在句子中间的听写开头，Intelligent Insert 会把它改成小写，除非它的第二个字母是大写。选中它，用 Quick Edit 说 capitalize this。
  • YapToText，Mac。 它需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本，Intel Mac 我不作任何保证。

每次都以同样方式写错的词可以教会，随机出现的错误则不行。

某个词仍然写错时

  1. 拷贝原始转写文本。 在 History 里，Show pipeline details 会显示 Whisper 听到了什么。在 Heard 里用这个确切的写法。
  2. 检查开关。 这个词典必须是打开的，而且模式必须使用它。
  3. 检查选项。 Whole word 可能挡住较长的词里面的匹配，Case 可能挡住不同的大小写。
  4. 检查顺序。 位置更高的条目可能先改写了同样的词。把你的条目拖到它上面。
  5. 多加几种写法。 加上 Whisper 写这个词的其他方式，或者按 Generate variations。
  6. 先修好声音。 如果出错的是很多词，而不是一个，先从麦克风入手。准确度指南 给出了顺序。
  7. 告诉我。 提交一个 GitHub issue，附上这个词、原始转写文本和这个条目。

Dictionaries 指南 介绍了这个页面上的每一个按钮。

简短版

  • Apple 听写。 没有词表。边听写边改蓝色下划线，并在你的 App 里试试 Text Replacements。
  • 语音控制。 有真正的自定义词汇，但它运行时标准听写是关闭的。
  • YapToText。 把 History 里的原始写法抄进 Heard，把你的写法填进 Replace with，然后按 Add。
  • 不用打字。 选中这个词，轻按 Right Option，说 add this to my dictionary。

听错的人名只要改一次，就会一直改对。

如果某个词改不过来，或者这一页和你看到的不一致，请 在 GitHub 上提交 issue。每一条我都会看。

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

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

指南

更多指南（英文）

资料来源

常见问题

怎样给 Mac 听写添加词汇？

Apple 的听写在设置里没有词表。在 YapToText 里，打开 Dictionaries 页面，把语音模型写出的写法填进 Heard，把你的写法填进 Replace with，然后按 Add。或者选中正确的写法，轻按 Right Option，说 add this to my dictionary。

为什么我的 Mac 听写总是把我的名字写错？

OpenAI 的 Whisper 提示指南说，Whisper 可能会写错不常见的专有名词，包括人名。在 YapToText 里，把它写出的写法作为 Heard，把你的名字作为 Replace with。你的名字随后还会用来给 Whisper 做提示。

Text Replacements 对 Mac 听写有效吗？

Apple 记录的是 Text Replacements 适用于许多 Mac App 里的文本，它的页面没有说是否适用于听写的文字，所以请在你的 App 里试一试。你可以用“编辑”，Substitutions，Show Substitutions，再点 Replace in Selection，把它们用在已有的文本上。

Mac 听写能学习自定义词汇吗？

“语音控制”可以：Apple 说，在“系统设置”的“无障碍”，“语音控制”里最多可以添加 1,000 个词条。“语音控制”打开时，标准听写不可用。

我的 YapToText 词典会离开我的 Mac 吗？

不会。词典保存在你 Mac 上 App 自己的容器里的一个文件 vocabulary.json 中，不会被任何东西同步。