拼写校验需手动启用插件、安装对应语言包并限定检查范围,否则无效或误标;默认禁用、缺语言包不报错、代码区误检、纠错菜单依赖光标位置及语法类型识别。

拼写校验不是开箱即用的功能,必须手动启用 spell-check 插件、安装对应语言包、并限制检查范围,否则要么全不生效,要么在代码里疯狂标红。
spell-check 插件没启用?先检查开关状态
新装的 Atom 默认禁用 spell-check 插件,它不会自动启动,也不会报错提示。你看到的“没反应”,大概率是插件压根没开。
- 按
Ctrl+,(Windows/Linux)或Cmd+,(macOS)打开设置 - 切换到 Packages 页签,搜索
spell-check - 确认右侧显示 Enabled;若为 Disabled,点
Enable按钮 - 无需重启,启用后立即对
text.plain、source.gfm(即 .md)、text.git-commit等语法类型生效
中文/日文不标红?缺语言包就白配
原生 spell-check 只带 en-US 词典。填了 zh-CN 却没效果?不是配置错了,是根本没装包。
- 在 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"
}
}
⚠️ 坑点:只改 languages 数组但不装包,Atom 会静默忽略该语言,不报错也不提示。
代码文件里全是红线?关掉非文本区域检查
默认情况下,spell-check 会对所有语法高亮区域扫描,包括字符串、注释、甚至变量名——但变量名拼错是语义问题,不是拼写问题。
- 进入
spell-check插件设置页(Packages →spell-check→ Settings) - 找到
Grammars to Check字段,删掉不需要检查的语法,例如:source.python、source.js - 保留真正需要拼写的范围,如:
text.plain、source.gfm、text.git-commit - 修改后需重新打开文件或切换标签页,实时检查才刷新
右键没 “Correct Spelling” 菜单?光标位置不对
纠错菜单不是全局可用的,它只在 spell-check 实际检测到错误单词、且光标落在该单词内部时才激活。
- 把光标停在被标红的单词中间(不能在开头或结尾空白处)
- 触发方式有三种:
Ctrl+Shift+;(Win/Linux)、Cmd+Shift+;(macOS)、右键 →Correct Spelling、命令面板搜Correct Spelling - 如果仍不弹出,说明当前单词未被识别为拼写错误(比如是专有名词、代码标识符,或语言包未覆盖)
最容易被忽略的是:拼写校验和语法高亮绑定紧密——.cson 文件若被识别为 Plain text,spell-check 就不会触发;同样,.vue 里的注释若语法类型是 text.html.vue 而非 source.gfm,也可能跳过检查。别只盯着配置,先看右下角语法标识是否正确。

















