Code Spell Checker 默认不检查未打开文件且依赖语言模式，需手动设置语言、启用插件、校验配置文件、切换英文输入法、正确放置光标，并通过问题面板筛选拼写问题后逐个修复。

拼写错误没标出来？先确认 Code Spell Checker 是否真在工作

插件装了不等于生效——它默认只检查打开的文件，且依赖语言模式识别。如果你右下角状态栏显示的是 Plain Text 或 Unknown，哪怕文件里全是英文注释，cSpell 也不会触发。

• 点击右下角语言模式标签，手动选成 JavaScript、Markdown 或对应语言（不是所有语言都默认启用拼写检查）
• cSpell.enabled 必须为 true；可在 settings.json 中确认：

  "cSpell.enabled": true

• 项目根目录若存在 .cspell.json 或 cspell.config.yaml，但语法错误或路径不对，插件会静默失败——用 VS Code 打开该配置文件，看有没有 JSON/YAML 校验报错

Ctrl+. 按了没反应？光标和输入法是最大干扰源

这不是快捷键坏了，而是语言服务没返回修复建议。最常见原因不是插件问题，而是光标停错了位置或输入法吞掉了组合键。

VSCode

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

下载

• 光标必须落在波浪线标记的单词**内部**（比如 consle 的任意一个字母上），停在空格、括号或注释末尾都不行
• 中文输入法（尤其是 macOS 的简体拼音、Windows 的搜狗）会劫持 Ctrl+. 或 Cmd+. 当作标点输入——切换到英文输入法再试
• 如果整个项目都没提示，检查 cSpell.diagnosticLevel 是否被设成 off 或 hint 但被其他设置覆盖；直接在设置搜索框输 cSpell.diagnosticLevel，确保值是 error 或 warning

误报太多？优先用 .cspell.json 而不是改全局设置

把 React、useState、API 这类词加进全局词典，等于污染所有项目。真正干净的做法是在项目根目录建配置文件，按需隔离。

• 创建 .cspell.json，至少包含：

  {
    "version": "0.2",
    "language": "en",
    "words": ["React", "useState", "JSON", "tsconfig"],
    "ignoreWords": ["TODO", "FIXME", "WIP"],
    "ignorePaths": ["node_modules/**", "dist/**", "**/build/**"]
  }

• words 是白名单（插件认可的词），ignoreWords 是黑名单（跳过检查，但不加入词典）——前者适合专有名词，后者适合临时标记
• 路径忽略支持 glob 模式，但注意：VS Code 不会自动 reload 配置，保存后需手动重新打开一个文件或执行 Developer: Reload Window

批量修复全项目？别指望一键全扫，得靠“问题”面板+手动筛选

cSpell 不提供“扫描整个 workspace 并替换所有拼写错误”的命令。所谓批量，其实是利用问题面板聚合结果，再逐个触发快速修复。

• 按 Ctrl+Shift+M（Windows/Linux）或 Cmd+Shift+M（macOS）打开“问题”面板
• 顶部筛选器选 Problems → Spelling，就能看到当前工作区所有拼写问题，按文件分组
• 点击某条问题，编辑器自动跳转到对应位置，此时再按 Ctrl+. 就能弹出修复菜单——这是唯一可靠的一键触发方式
• 注意：面板里显示的“12 problems”可能包含已修复但未刷新的问题，关闭并重开面板或执行 Developer: Restart Language Server 可清缓存

真正麻烦的从来不是发现错误，而是判断哪个该修、哪个该加进 words、哪个该放进 ignoreWords——这一步没法自动化，得人眼过一遍。