Zettlr 拼写检查完全指南：三步配置多语言词典，告别误报红波浪线
【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr
用 Zettlr 写一份德语和英语混排的文档，很多人都会踩同一个坑：Büro、Grüße明明是拼写正确的德语，却被标得全是红波浪线——原因很简单，Zettlr 拼写检查默认没把德语词典挂上。好消息是：只要配好多语言词典和自定义词典，混排文档基本不会再被误伤。下面按"先懂原理 → 快速开启 → 混排实战 → 排错"的顺序，把这件事一次讲清。
一、先看懂机制：一个引擎，多个词典
结论先行：Zettlr 拼写检查底层是 Hunspell 引擎，靠"按语言加载词典、逐词校验"工作，而不是对全文猜语言。
每个词典由两个文件组成：
.dic文件：单词列表，即"哪些词算对"；.aff文件：词缀规则，负责词形变化。比如 static/dict/en-US/en-US.aff 里就定义了re-、un-这类前缀规则，让retype、unfair这样的词不用逐个收录也能通过检查。
仓库内置词典放在 static/dict 目录下，目前提供 de-DE、en-GB、en-US、es-ES、fr-FR、nl-NL、ru-RU、tr-TR、uk-UK 共九种语言，每种语言一个子目录，里面就是同名的.aff+.dic两个文件。
有一个关键设计要记住：Zettlr 做的是"并集"检查——一个词只要被任一已启用词典认可，就判定为正确。这也意味着它不需要像某些编辑器那样在文中插"语言标记"来切换检查规则：启用了哪几个语言，全文就同时按这几套规则校验。另外代码里有个兜底：当你配置的语言码找不到完全匹配的词典时，会回退到 en-US。
二、三步开启：最快的 Zettlr 拼写检查配置方法
第 1 步：打开偏好设置。进入"偏好设置（Preferences）"，在左侧找到"拼写检查（Spellchecking）"标签页（较老版本中它挂在"编辑器（Editor）"分组下，直接搜 spell 也能快速定位）。
第 2 步：勾选要启用的语言。页面第一张卡片是语言列表，带"启用 / 语言 / 语言码"三列，支持搜索过滤。勾选你需要的所有语言即可多选，比如同时勾 en-US 和 de-DE。注意默认状态是一个词典都不启用（为了加快首次启动），勾完保存即生效，无需重启——Zettlr 会在配置变化时实时热加载词典。
第 3 步：回编辑器验证。打开一篇混排文档，正确的多语言单词不再标红，只留下真正的拼写错误；悬停标红单词可以查看建议的更正词。
三、多语言混排的两个典型场景
场景 A：德语 + 英语的技术笔记。你在写一份以德语为主、夹杂英文术语的笔记。操作只需两步：在语言列表里同时启用 de-DE 和 en-US；把词典里没有的自造术语（比如内部项目代号）加进自定义词典（见下一节）。由于是并集检查，德英混排段落不需要任何额外标记，两套规则同时生效。
场景 B：英式 + 美式英语同时出现。这是最容易互相误伤的组合同——colour和color在各自词典里都对，只启用 en-US 时前者必被标红。解法很直接：en-GB 和 en-US 两个词典一起启用。同理，如果文档里同时有café（法语/西语来源的词）和cafe，把 es-ES 或 fr-FR 也挂上即可。
一个实用建议：按需启用，不要全勾。语言勾得越多，单词"通过检查"的概率越高，真正的错误反而可能被别的词典"放行"。只启用文档实际用到的语言，误报最少。
四、自定义词典：把误报词一次性解决
自定义词典（User Dictionary）是解决个别顽固误报最省事的途径，全程在界面里操作，不用碰文件。
- 在"拼写检查"页往下找到"用户词典（User Dictionary）"卡片，这里可以查看、搜索、删除已加入的词；
- 在编辑器里遇到被误标红的词时，通过右键菜单的词典操作可把它加入用户词典；
- 加完立刻生效，无需重启。
如果你的需求不是加词、而是要装一整门新的语言词典（比如内置列表里没有的语言），走"安装词典（Install Dictionaries）"卡片：点"打开词典文件夹（Open dictionary folder）"按钮，会直接打开你的用户词典目录（注意它和仓库源码里的 static/dict 不是一个地方，后者只是随包发布的词典源）。按约定放入文件即可：新建一个以语言码命名的子目录，里面放<语言码>.aff和<语言码>.dic两个文件（index.aff/index.dic命名也接受）。装好后回到语言列表勾选，就会出现在可用词典中；如果语言码与内置词典相同，你的版本还会优先覆盖内置版本。
五、常见问题排错
遇到标红行为不符合预期时，按下面几条对号入座：
- 带引号的词被误报：不用处理，Zettlr 检查前会自动把弯引号（
’‘“”等）统一转成直引号，don't这类词不会出现引号问题。 - 含数字的词如
version2.0：拼写检查只提取其中的字母连续段，数字和符号会断开单词，所以它实际只检查version这一段，一般不算误报。 - 连字符词：如
state-of-the-art会拆成若干独立词分别检查，若某一段是生僻缩写被标红，把该词整体加入自定义词典最干净。 - 全文大量标红、像没启用词典一样：先回偏好设置确认对应语言真的勾选了，且语言码拼写正确；勾错语言是最常见原因。
- 想要语法和风格检查：同一页面下还有 LanguageTool 集成，开启后除拼写外还能查语法、风格问题，可设置严格度（标准/挑剔）、母语，甚至切换官方服务器或自建服务器。
词典用久了可以顺手清理一下用户词典里的过期词条，让自定义词典保持精简。内置词典列表会随版本更新，想加词或换规则，回到"偏好设置 → 拼写检查"这一个入口就够了——配置完成之后，混排文档的误报问题基本就翻篇了。
【免费下载链接】ZettlrYour One-Stop Publication Workbench项目地址: https://gitcode.com/GitHub_Trending/ze/Zettlr
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
