code spell checker需手动配置白名单才能识别专有名词和缩写;可通过项目级.cspell.json的"words"字段、行内// cspell:ignore注释或cspell.ignoreregexplist正则批量忽略。

Code Spell Checker 默认不会忽略你写的专有名词或缩写,必须手动加白名单,否则“ReactQuery”“ZodSchema”这类词永远被标红。
在项目级配置中添加 words 字段
项目里反复出现但拼写“不标准”的术语(比如内部 API 名、库名、自定义 Hook),适合统一加到项目根目录的 .cspell.json 里。插件会优先读取这个文件,比全局设置更精准。
- 在项目根目录创建或编辑
.cspell.json - 确保包含
"words"数组,例如:{ "words": ["ReactQuery", "ZodSchema", "JWT", "APIKey"] } - 保存后,这些词在当前项目所有文件中都不再触发拼写警告
用 // cSpell:ignore 行内临时忽略
某些字符串里混着路径、占位符或动态片段(如 `/user/${id}/profile`),不适合全局加词,更适合单行控制。
- 在该行末尾添加注释:
// cSpell:ignore myCustomId, apiV2, userId - 支持空格或逗号分隔多个词,大小写敏感
- 只对当前行生效,不影响其他地方
通过 cSpell.ignoreRegExpList 批量跳过模式
重复出现的干扰模式(如全大写缩写、带下划线的环境变量)靠一个个加词太累,正则更省事。
- 在
settings.json或.cspell.json中添加:"cSpell.ignoreRegExpList": ["\b[A-Z]{2,}\b", "\b[A-Z]+_[A-Z_]+\b"] - 第一个正则跳过所有 ≥2 个大写字母组成的单词(如
HTTP、UIKIT) - 第二个跳过类似
NODE_ENV、API_VERSION的下划线大写组合 - 注意:正则需用双反斜杠转义,且不能跨行匹配
真正容易被忽略的是:加了 words 却没确认文件是否被插件识别——如果 .cspell.json 放错位置(比如在 src/ 子目录下),或者当前文件语言 ID 不在 cSpell.enabledLanguageIds 列表里,那些词照样标红。











