code spell checker 插件无反应，需检查启用状态、文件语言模式及cspell.language配置；默认仅检查注释/字符串/markdown，不查变量名；依赖语法高亮识别scope；项目级用cspell.json管理词典和忽略路径；ci/cd应使用cspell cli而非插件。

Code Spell Checker 插件装完没反应？检查启用状态和语言配置

插件安装后不标红拼写错误，大概率是没激活或语言没匹配上。Code Spell Checker 默认只对注释、字符串、Markdown 文本生效，不会检查变量名或关键字——这是设计使然，不是 bug。

实操建议：

• 确认插件已启用：在 VSCode 扩展面板搜 Code Spell Checker，看右下角是否显示「已启用」
• 检查当前文件语言模式：右下角状态栏点击语言标识（如 JavaScript），确保不是 Plain Text 或未识别类型；某些自定义后缀（如 .vue 或 .astro）需手动设置语言为 Vue / Astro
• 打开设置搜索 cSpell.language，确认值包含当前项目常用语言，例如："en, zh"；中文拼写检查需额外启用 cSpell.allowCompoundWords 否则“用户名”“登录页”会被误标

为什么字符串里的英文没被检查？确认 scope 和语法高亮是否正常

拼写检查依赖 VSCode 的语法高亮（TextMate grammar）来识别字符串、注释等 scope。如果语法解析失败，Code Spell Checker 就找不到可检查的文本范围。

常见错误现象：

• console.log("helo world") 完全不报错
• JSX 中的 {"hello"} 被跳过，但双引号字符串正常
• Vue 模板里 <p>wroong</p> 无提示

原因和对策：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 检查当前文件是否被正确识别：按 Ctrl+Shift+P → 输入 Change Language Mode → 确认是 JavaScript React 而非 JavaScript（后者不支持 JSX 字符串）
• Vue 文件需安装 Volar（非 Vetur），否则 <template></template> 内容无法被语法解析器提取
• 临时验证：在文件顶部加一行 // spell-checker: disable，再删掉——如果这时突然开始标红，说明之前被全局禁用了

误报太多？用字典和忽略规则精准控制检查边界

默认词典太宽泛，尤其在技术项目里，“useState”、“zustand”、“jsx” 都会被标红。靠右键“添加到用户词典”效率低，还容易污染全局配置。

推荐做法：

• 项目级词典优先：在项目根目录建 cspell.json，用 cSpell.words 加白名单，例如：

  {"words": ["zustand", "vitepress", "tsconfig"]}

• 忽略路径更安全：用 cSpell.ignorePaths 排除 node_modules/**、dist/**、**/*.min.js，避免扫描压缩代码引发卡顿
• 慎用 cSpell.enabled 全局开关：它会关闭所有检查，包括你真正需要的 README.md；改用 cSpell.languageId 按语言精细控制，比如禁用 jsonc 但保留 markdown

CI/CD 里想自动检查拼写？别依赖 VSCode 插件

Code Spell Checker 是 VSCode 前端插件，没有命令行入口，也不能直接集成进 GitHub Actions 或 husky。

替代方案很明确：

• 用开源 CLI 工具 cspell（同团队出品）：运行 npx cspell "**/*.{js,ts,md}" 即可复现编辑器逻辑
• 注意配置同步：CLI 默认读取 cspell.json，但不会自动加载 VSCode 用户设置里的 cSpell.* 项，必须显式声明
• 性能敏感场景：加 --no-progress --quiet 参数，避免 CI 日志刷屏；大仓库建议限定路径，如 src/**/*.{ts,md}

最常被忽略的一点：VSCode 插件的「快速修复」（Alt+Enter 添加单词）不会同步到 cspell.json，每次手动加都要去 CLI 配置里补一遍，否则本地过了 CI 还是会挂。