atom拼写检查需同时满足插件启用、语言包安装、语法范围配置正确三条件;spell-check默认禁用,须手动开启;中文/日文需安装对应语言包并严格匹配zh-cn;grammars to check须精简为text.plain等非代码语法;右键纠错菜单仅在光标位于标红单词内部且语法在白名单时生效。

Atom 的拼写检查不会自动生效,必须同时满足三个条件:插件已启用、对应语言包已安装、语法范围配置正确。缺一不可,否则连红色波浪线都不会出现。
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 只带 en-US 词典。只在 config.cson 里写 ["zh-CN"] 是白忙——Atom 会静默忽略,不报错、不提示、不标红。
- 在 Packages 设置页搜索并安装
spell-check-language-zh(中文)或spell-check-language-ja(日文) - 打开
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 - 改完后需重新打开文件或切换标签页,检查才会刷新
右键“Correct Spelling”菜单不弹?光标位置和语法类型双约束
这个菜单不是始终可用的,它只在两个条件同时成立时才激活:① 当前单词已被标红;② 光标落在该单词**内部**(不能在前后空白、标点或引号外);③ 当前文件语法在 Grammars to Check 列表中。
- 右键菜单灰色不可点?先确认光标是否停在错误单词中间
- 快捷键更可靠:
Ctrl+Shift+;(Win/Linux)或Cmd+Shift+;(macOS)可强制唤出纠错面板 - 验证是否生效最简单的方法:新建一个
.txt文件,输入helo,看是否标红并能触发纠错
最容易被跳过的是语言包安装和插件启用这两个独立动作——它们不联动,也不报错,只是默默失效。而菜单是否出现,取决于光标位置与语法白名单的双重匹配,不是功能坏了,是条件没凑齐。











