Code Spell Checker装完不标红,90%因插件未启用、语言模式错误或cSpell.language未配对;需确认右下角显示Spell图标、文件语言为javascriptreact等有效ID,并配置cSpell.language为["en","zh-CN"]、启用allowCompoundWords及安装官方中文词典扩展。
装完插件不标红,基本不是插件坏了,而是它根本没跑起来——右下角没
图标、语言模式不对、
没配对,三者占九成原因。
右下角没 Spell 图标?插件压根没激活
插件安装 ≠ 启用 ≠ 生效。VSCode 不会弹窗提醒你配错了,只会安静地跳过所有检查。
打开任意
或
文件,盯住右下角状态栏:必须出现
字样或语言码(如
),否则插件没加载到当前上下文
进扩展面板搜
,确认右下角显示的是「已启用」,不是「已安装」
按
(Win/Linux)或
(Mac),输入
回车,强制开关一次,有时能触发重载
检查
里有没有残留的
—— 这个全局禁用项一旦存在,其他配置全作废
JSX/TSX 字符串不标红?语言模式错了
拼写检查严重依赖 VSCode 的语言 ID 来提取字符串和注释。JSX 中的
、Vue 模板里的文本、TSX 的属性值,全靠正确语言模式触发。
右下角点语言标识,把
改成
;
改成
文件需手动设为
(不是
),否则
内容无法解析出可检查文本
在
中确认有:
临时验证法:在文件顶部加一行
,保存后再删掉——如果这时突然开始标红,说明之前被某处静默禁用了
cSpell.language 怎么配才管用
只写
,中文注释和中英混排字符串永远被无视;写成
才能稳定识别“登录页”“用户名”这类复合词,但必须搭配
。
VSCode 1.118
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力,其中最引人注目的是新增 Copilot CLI 远程控制功能,允许开发者通过手机或网页远程监控和接管 AI 会话 。同时,为了提高 AI 的运行性价比,新版本优化了令牌缓存策略以降低成本 。此外,1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
下载
必须是数组格式:
,不能是字符串
必须装官方词典扩展:
(作者
),第三方“Chinese Spell Checker”不兼容
设为
,否则
会被拆成
和
,两个都报错
别用
加单个词如
和
—— 这会让
(无大写)也被放过,失去检查意义;应该加驼峰形式:
、
变量名/函数名为啥不标红?这是设计,不是 bug
默认不查
、
、
这类标识符,因为它们属于代码逻辑部分,拼错可能是有意缩写(比如
代替
)。要让它查,得手动开严格模式。
启用
并设为
或
确保
包含你实际用的语言 ID(如
、
)
高频 API 必须白名单化:在
加
,注意大小写敏感
CI/CD 里别指望插件起作用——它依赖 GUI 和语言服务上下文,必须换 CLI:
最常被忽略的其实是语言模式和词典扩展的绑定关系:没有
,
就是空转;没把
文件语言设成
,模板字符串里的错词就永远看不见。
SpellcSpell.language.js.mdSpellenCode Spell CheckerCtrl+Shift+PCmd+Shift+PSpell Checker: Togglesettings.json"cSpell.enabled": false{"succes"}JavaScriptJavaScript ReactTypeScriptTypeScript React.vueVueHTMLsettings.json"cSpell.enabledLanguageIds": ["javascriptreact", "typescriptreact", "vue"]// spell-checker: disable"en""zh-CN"cSpell.allowCompoundWords: true"cSpell.language": ["en", "zh-CN"]"en, zh-CN"cSpell Dict ChinesestreetsidesoftwarecSpell.allowCompoundWordstrueuseStoreusestorecSpell.userWords"user""info"userinfo"userInfo""httpStatus"consoledocumentuseStateusrusercSpell.diagnosticLevel"Hint""Information"cSpell.enabledLanguageIds"javascript""typescript"settings.json"cSpell.userWords": ["console", "document", "fetch", "localStorage"]npx cspell --no-progress "**/*.{js,ts,md}" --ignore="node_modules/**" --ignore="dist/**"cSpell Dict Chinesezh-CN.tsxTypeScript React