Code Spell Checker 默认不检查中文，需单独安装 CSpell Chinese Dictionary 扩展、重启 VSCode，并在 cspell.json 中配置 "language": ["zh-CN"] 和 "dictionaries": ["chinese"]，同时禁用 english 词典、关闭 checkIdentifiers 才能正确校验中文注释与字符串。
Code Spell Checker 默认不检查中文，装完插件后写“初始化变量”依然没波浪线——不是插件坏了，是它根本没加载中文词典，也没被告知该去校验中文。
安装 CSpell 中文词典扩展
插件本体（Code Spell Checker）和中文词典是分开的。不装词典，cSpell.language 设成 zh-CN 也白搭。
- 按
Cmd+Shift+X（macOS）打开扩展面板，搜cspell-dict-chinese或code spell checker chinese - 认准作者是
Street Side Software的那个官方扩展（名称通常为CSpell Chinese Dictionary） - 点击安装，装完必须重启 VSCode——否则词典不会注册进插件运行时
cspell.json 里必须显式启用 chinese 词典
只在 settings.json 里加 "zh-CN" 不够。插件默认只启用英文词典，中文词典得在项目级配置里手动“点名”启用。
- 在项目根目录创建或编辑
cspell.json - 确保包含
"language": ["zh-CN"]和"dictionaries": ["chinese"]两个字段 -
"dictionaries"值必须是字符串"chinese"，不是"zh"或"chinese-dict"，拼错就无效 - 保存后，VSCode 会自动 reload 规则；如果没反应，可手动执行命令
Developer: Reload Window
禁用 english 词典避免拼音误判
中文变量名如 userName、注释里的 “张三”“李四”，会被 english 词典当成英文人名放过，导致漏检。这不是 bug，是设计如此。
- 打开
settings.json，把cSpell.language改成["zh-CN"]（去掉"en"） - 或者更彻底：在
cspell.json中加"enableFiletypes": ["*"]并确认"dictionaries"里没留"english" - 验证方式：在注释里写 “初始化变理”，看是否被标红——如果没标，说明英文词典还在干扰
cSpell.checkIdentifiers 设为 false 才不误伤变量名
中文变量命名（如 用户列表、订单状态）在 JS/TS 中合法，但 Code Spell Checker 默认会检查所有标识符，结果把整个变量名标红，纯属干扰。
- 在
settings.json中添加："cSpell.checkIdentifiers": false - 同时建议加上：
"cSpell.wordsOnlyCheckInCommentsAndStrings": true - 这样插件只盯注释、字符串里的中文词，对
const 用户列表 = [];这类代码完全静音 - 注意：这个设置是全局生效的，如果团队有不同习惯，应改用工作区
cspell.json覆盖
最常被跳过的其实是词典加载状态验证——装完扩展、配完 cspell.json 后，打开命令面板（Cmd+Shift+P），输入 Spell Checker: Show Diagnostics，能看到当前激活了哪些词典和语言。没看到 chinese，前面所有配置都白做。
