code spell checker 是 vs code 中唯一值得长期依赖的拼写检查插件，因其支持上下文识别（如区分驼峰变量与错误拼写）、仅检查字符串和注释、可配置忽略规则及团队共享的 .cspell.json 配置。
Code Spell Checker 是目前 VS Code 中唯一值得长期依赖的拼写检查插件，其他同类工具要么功能残缺，要么维护停滞。
为什么必须用 Code Spell Checker 而不是系统自带或其它插件
VS Code 本身完全不提供拼写检查能力，所谓“自带”纯属误解；而像 Polish 或 Spelling Navigator 这类插件，只覆盖 Markdown 或纯文本，对 .py、.ts 文件里的字符串和注释基本无效。Code Spell Checker 的核心优势在于它能区分上下文：userName 不会报错（识别为驼峰变量），但 recieveData 会被标红（recieve 是错误拼写）；JWT 默认忽略（全大写缩写），而 jsonwebtoken 会被正常校验。
- 它默认禁用对代码标识符（变量名、函数名）的检查，避免干扰开发节奏
- 支持
cSpell.stringsOnly: true进一步收缩范围，只查字符串字面量和注释 - 中文支持有限，但拼音模糊匹配对简单词汇（如“login”误写成“logn”）有一定识别力
安装后立刻生效，但默认配置容易误报
装完插件不用重启，打开任意 .js 或 .py 文件就能看到波浪线。但开箱即用的默认行为常把合法缩写标红，比如 apiV2、uiKit、localhost —— 这些不是拼错，是命名习惯。
- 右键点击错词 → “Add to User Dictionary” 可全局记住该词（适合团队通用术语）
- 在文件顶部加
// cSpell:ignore apiV2, uiKit，临时跳过本文件检测 - 修改
settings.json，加入"cSpell.ignoreRegExpList": ["\b[A-Z]{2,}\b"]，自动忽略所有全大写单词 - 禁用对
json文件的检查：把"json"从cSpell.enableFiletypes列表里删掉，避免"auth_token"键名被误判
团队协作时必须配 .cspell.json 而非用户 settings.json
靠个人 settings.json 配置无法同步到同事环境，也进不了 Git。项目根目录下建 .cspell.json 才是正确做法，内容示例如下：
{
"language": "en-US",
"words": ["zustand", "vitepress", "nextauth"],
"ignorePaths": ["node_modules/**", "dist/**"],
"enabledLanguageIds": ["javascript", "typescript", "python", "markdown"]
}
这个文件会被所有成员的 Code Spell Checker 自动读取。注意：cSpell.allowCompoundWords 设为 true 可减少 userProfile 类驼峰词被误报，但别开在全局，只放项目配置里。
真正麻烦的不是装插件，而是让检查范围刚好卡在「该提醒的时候提醒，不该打扰的时候安静」——这需要你动手调几次 cSpell.ignoreRegExpList 和 enabledLanguageIds，而不是堆砌一堆“智能”开关。
