Atom 中文拼写检查需同时启用 spell-check 插件、安装 spell-check-language-zh 包、在 config.cson 中正确配置 languages 为 ["zh-CN","en-US"],并精简 Grammars to Check 列表,否则不标红也不提示。

Atom 本身不提供“中文错误提示”,所谓“中文错误提示”实际是拼写检查(spell-check)插件对中文文本的标红 + 纠错建议,它依赖语言包、语法范围和启用状态三者协同——缺一不可,否则连波浪线都不会出现。
spell-check 插件必须手动启用才生效
新装 Atom 默认禁用 spell-check,所有后续配置都无效。这不是 bug,是设计如此。
- 按
Ctrl+,(Windows/Linux)或Cmd+,(macOS)打开设置 - 切换到 Packages 标签页
- 搜索
spell-check,确认右侧显示 Enabled;若为 Disabled,点 Enable 按钮 - 启用后无需重启,
text.plain、source.gfm(即 .md 文件)、text.git-commit等默认语法立即开始检查
中文拼写检查必须装 spell-check-language-zh
原生 spell-check 只带 en-US 词典。config.cson 里只写 ["zh-CN"] 是白忙——Atom 会静默忽略,不报错、不提示、不标红。
- 在 Packages 设置页搜索并安装
spell-check-language-zh(注意不是language-chinese-simplified,后者只管语法高亮) - 打开
config.cson(Settings → Open Config Folder),添加或修改如下内容:
{"spell-check": {"languages": ["zh-CN","en-US"],"fallbackLanguage":"en-US"}}
注意:zh-CN 必须与已安装的语言包严格匹配;zh、zh_CN、zh-cn 均无效。
Grammars to Check 必须精简,否则代码文件满屏红线
spell-check 默认扫描所有语法高亮区域,包括 source.js 字符串、source.python 注释甚至变量名——这不是误报,是你没关对范围。
- 进入 Packages → spell-check → Settings
- 找到 Grammars to Check 字段,清空它
- 手动加回真正需检查的语法,例如:
text.plain、source.gfm、text.git-commit、source.asciidoc - 务必删掉
source.js、source.python、source.css等代码类 grammar - 改完后需重新打开文件或切换标签页,检查才会刷新
右键纠错菜单不弹?光标位置和语法类型双约束
这个菜单不是始终可用的,它只在两个条件同时成立时才激活:
- 当前单词已被标红(说明拼写检查已跑通)
- 光标落在该单词内部(不能在前后空白、标点或引号外)
- 当前文件语法在 Grammars to Check 列表中
右键菜单灰色不可点?先确认光标是否停在错误单词中间。更可靠的是快捷键:Ctrl+Shift+;(Win/Linux)或 Cmd+Shift+;(macOS)可强制唤出纠错面板。
最容易被忽略的是:拼写检查和界面汉化完全无关——atom-simplified-chinese-menu 管菜单翻译,spell-check-language-zh 管中文纠错,装错包或开关漏开,都会导致“看起来设了,但没反应”。

















