Code Spell Checker 装完不标红,90% 是插件未激活或未加载到当前文件上下文:右下角必须显示 Spell 图标或 en/zh-CN 等语言标识;需确认插件“已启用”而非仅“已安装”,并确保文件语言模式为 TypeScript React 或 JavaScript React,同时检查 settings.json 中无 "cSpell.enabled": false 全局禁用项。

Code Spell Checker 插件装完不自动全局生效,必须手动确认启用状态、语言配置和检查范围——否则它只在极少数文件里“假装工作”。
右下角没 Spell 图标?插件根本没加载到当前文件
VSCode 不会弹窗提示插件失效,只会安静跳过。关键判断依据只有右下角状态栏:Spell 图标或类似 en/zh-CN 的语言标识。没有它,其他所有设置都白搭。
- 打开任意
.ts、.js或.md文件,盯住右下角;如果不是Spell或语言码,说明插件未激活上下文 - 进扩展面板搜
Code Spell Checker,确认显示的是「已启用」,不是「已安装」 - 按
Cmd+Shift+P(Mac)或Ctrl+Shift+P(Win/Linux),输入Spell Checker: Toggle回车,强制重载一次 - 检查
settings.json里有没有"cSpell.enabled": false——这个配置一存在,整个插件直接瘫痪
cSpell.language 和 enabledLanguageIds 必须显式配对
只设 "cSpell.language": "en, zh" 不够。插件默认对所有语言 ID 启用检查,但很多文件类型(比如 plaintext、json)根本不该被扫,反而导致误报或卡顿。
- 在
settings.json中同时配置这两项:"cSpell.language": "en, zh""cSpell.enabledLanguageIds": ["typescript", "javascript", "markdown", "json"] - 避免写
"*"或漏掉markdown——README 和文档注释就靠它 - 若项目含
.vue,确保已装Volar(不是 Vetur),否则<template></template>里的字符串压根不会被提取
中文注释整段标红?缺这三个配置中的任意一个都会失败
Code Spell Checker 默认把中文当英文单词查词典,结果每个字都报错。要让它合理分词,必须三者齐备:
-
"cSpell.wordsOnlyCheckInCommentsAndStrings": true—— 禁止检查代码符号(如const、{) -
"cSpell.language": "en, zh"—— 显式声明支持中文,不能只留en -
"cSpell.checkIdentifiers": false—— 关闭对变量名、函数名的检查,否则useEffect这类词也会触发
为什么改了 settings.json 还不生效?检查这三处静默拦截点
插件优先级规则很隐蔽:用户设置 > 工作区设置 > 项目根目录 .cspell.json。只要其中一处禁用或路径错配,全局设置就作废。
- 项目根目录若有
.cspell.json或cspell.config.yaml,打开它看是否有语法错误(VSCode 会标红) - 检查
files.associations是否把*.ts错映射成plaintext——这种配置会让插件跳过整个文件类型 - 临时验证法:在文件顶部加一行
// spell-checker: disable,保存;再删掉。如果这时突然开始标红,说明之前被某处静默禁用了
真正麻烦的不是配置本身,而是 VSCode 对「已启用」和「已加载」不做区分,也不反馈失败原因。盯住右下角那个小图标,比翻十遍文档都管用。


















