spell-check插件未生效需先启用插件,再安装对应语言包并正确配置languages数组;默认仅支持英文,中文/日文需额外安装spell-check-language-zh或-ja包,并在config.cson中指定语言代码。

spell-check 插件没生效?先确认是否已启用
Atom 的拼写检查不是开箱即用的默认功能,它依赖 spell-check 插件,而这个插件在新安装的 Atom 中默认是禁用的。如果你没看到红色波浪线,第一反应不应该是“语言没配对”,而是“插件压根没开”。
- 打开设置:按
Ctrl+,(Windows/Linux)或Cmd+,(macOS) - 切换到 Packages 选项卡
- 搜索
spell-check,确认状态栏显示 Enabled;若为 Disabled,点击右侧 Enable 按钮 - 无需重启,启用后立即对当前打开的
text.plain、source.gfm(即 .md 文件)、text.git-commit等默认语法类型生效
想检查中文/日文?必须装对应语言包
原生 spell-check 只带英文词典(en-US),中文、日文等语言需要额外安装语言支持包——这不是配置开关能解决的,缺包就完全不识别。
- 在 Packages 设置页搜索
spell-check-language-zh(中文)或spell-check-language-ja(日文),安装对应包 - 安装后需手动指定语言:打开
config.cson(通过 Settings → Open Config Folder),添加或修改spell-check配置段 - 示例配置(支持中英双语,优先中文):
{ "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, source.asciidoc - 或者更稳妥:清空该字段,再逐个加回你需要的语言类语法,避免误伤
- 注意:修改后需重新打开文件或切换标签页,实时检查才刷新
右键“Correct Spelling”不弹菜单?快捷键和上下文有关
拼写纠错菜单不是全局可用的,它只在 spell-check 实际检测到错误单词、且光标落在该单词内部时才激活。
- 触发方式有三种:
Ctrl+Shift+;(Win/Linux)、Cmd+Shift+;(macOS)、右键 → Correct Spelling、命令面板搜Correct Spelling - 常见失效场景:光标停在空格/标点上、单词被引号或括号包裹但未完整选中、当前语法未列入
Grammars to Check - 如果始终不弹,可临时在纯文本文件(.txt)里输入
helo测试——这是最干净的验证路径
spell-check-language-zh,zh-CN 就只是配置文件里一行无效文字。










