Atom 中文注释下红色波浪线基本由默认启用的 spell-check 插件导致,因其仅支持英文词典;关闭该插件或在 config.cson 中配置 scopeBlacklist: ["comment", "string"] 即可消除。

Atom 编辑器里中文注释下的红色波浪线,基本可以锁定是 spell-check 插件干的——它默认启用、默认只认英文词典,遇到中文就全标为“拼写错误”。这不是代码问题,也不是编码问题,关掉或配对它就能立刻清爽。
确认是不是 spell-check 插件在作怪
Atom 默认自带 spell-check 插件,且默认开启。它不区分语言,会扫描所有文本内容(包括注释、字符串、Markdown 段落),只要分词后找不到匹配词,就画红线。
- 打开 Atom → Atom → Preferences(macOS)或 Edit → Preferences(Windows/Linux)
- 左侧点 Installed Packages,在搜索框输入
spell-check - 如果状态是 Enabled,那八成就是它;如果已禁用,再检查是否装了其它带拼写功能的插件(比如
linter-spell、atom-ide-diagnostics等)
直接禁用 spell-check 插件(最简方案)
如果你不需要任何拼写检查(尤其主要写中文/混合注释),关掉最省心,且不影响语法高亮、自动补全等核心功能。
- 在
spell-check插件详情页,点击右下角 Disable 按钮 - 关闭并重启 Atom(部分版本需重启才生效)
- 验证:打开一个含中文注释的文件,红线应立即消失
保留 spell-check 但只禁用中文区域(进阶配置)
如果你仍想保留英文注释/文档的拼写提示,只是不想让中文被误伤,就得改它的作用范围。关键在于控制它“不扫描哪些语法作用域”。
- 进入 Atom → Config...(或 Edit → Config...)
- 在打开的
config.cson文件中,找到或新增spell-check配置段:
"spell-check":
grammars: [
"source.js"
"source.python"
"text.html.basic"
# 去掉 "source.c", "source.cpp", "text.plain" 等泛用语法
# 或明确排除注释作用域:不推荐直接删,而是用 scopeBlacklist
]
scopeBlacklist: [
"comment"
"string"
]
注意:scopeBlacklist 是关键——它告诉插件跳过所有 comment(注释)和 string(字符串)节点,中文自然不再被检查。这个配置比单纯关插件更精细,也避免影响 README.md 里的英文拼写提示。
检查其他插件是否叠加干扰
有些第三方插件(如 linter-spell、language-chinese 的旧版、甚至某些主题包)会自带独立拼写逻辑,它们的设置不随 spell-check 主开关变化。
- 回到 Installed Packages 页面,逐个排查名称含
spell、linter、grammar的插件 - 对疑似插件,点开查看详情 → 查看是否有
ignoreScopes、disabledScopes或locales配置项 - 例如
linter-spell支持配置"zh-CN"为允许语言,但多数人用不到这么细,直接禁用更稳妥
真正容易被忽略的是:Atom 的 spell-check 不会因你装了中文语言包(language-chinese)而自动适配——它压根不读取系统语言或编辑器 UI 语言,只依赖词典和作用域规则。所以别指望换语言界面能解决问题,得动配置或关插件。

















