spell-check插件需先启用、再装语言包、最后配置语法范围，三者缺一不可；未启用则配置无效，未装语言包则静默忽略，语法范围不匹配则不标红也不弹窗。

spell-check 插件默认禁用，不装包、不配语法、不调语言，它根本不会标红任何单词。

启用 spell-check 插件是第一步，不是可选项

Atom 新装后 spell-check 包处于禁用状态，即使你改了配置也不会生效：

• 按 Ctrl+,（Windows/Linux）或 Cmd+,（macOS）打开设置
• 切到 Packages 页签，搜索 spell-check
• 点击 Enable 按钮 —— 不需要重启，当前文件立刻开始检查

如果你跳过这步直接去改 config.cson，所有配置都白写。

只配 languages 数组，中文/日文照样不工作

spell-check 原生只带 en-US 词典，zh-CN 或 ja-JP 必须额外安装对应语言包：

• 在 Packages 设置页搜索 spell-check-language-zh 并安装（中文）
• 或搜索 spell-check-language-ja（日文）
• 再在 config.cson 中写入：

  {
    "spell-check": {
      "languages": ["zh-CN", "en-US"],
      "fallbackLanguage": "en-US"
    }
  }

• ⚠️ 坑点：只改 languages 但没装包，Atom 静默忽略该语言，不报错也不提示

Grammar to Check 控制“哪些区域被扫描”，别让它误伤代码

默认它会检查 text.plain、source.gfm（即 .md）、text.git-commit，但也会扫进 source.js 的字符串和注释里——变量名拼错不是拼写问题，标红反而干扰：

• 进入 spell-check 插件的 Settings 页面
• 找到 Grammars to Check 字段
• 清空它，然后手动加回你需要的语言类语法，比如：text.plain、source.gfm、source.asciidoc
• 删掉 source.python、source.js 等代码类 grammar，避免注释/字符串被过度检查
• 修改后需重新打开文件或切换标签页，实时检查才刷新

拼写纠错菜单不弹？光标位置和语法类型才是关键

cmd-:（macOS）或 Ctrl-:（Windows/Linux）唤出的纠错菜单，只在满足两个条件时激活：

• 光标必须落在被标红的错误单词**内部**（不能停在空格、标点或引号外）
• 当前文件语法必须在 Grammars to Check 列表中
• 如果始终不弹，最干净的验证方式：新建一个 .txt 文件，输入 helo，看是否标红并能唤出菜单
• 右键菜单里“Correct Spelling”项也是同理，不在有效语法+有效光标位置下就是灰色不可点

真正容易被忽略的是：拼写检查不是全局开关，它是语法驱动 + 语言包依赖 + 光标上下文敏感的三重条件组合。少一个环节，就只是看着插件开着，实际什么也不做。