vscode中文界面需手动执行configure display language命令才能生效,装插件后不重启或改设置无效;中文注释翻译需额外插件;输入法冲突时应使用命令面板格式化;code spell checker默认不检查中文变量名。

中文界面切换必须用 Configure Display Language 命令
VSCode 的中文语言包本身不自动生效,装完插件后 UI 仍是英文——这是新手最常卡住的一步。关键不是重启或重装,而是必须手动触发语言切换命令。
操作路径固定:Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)→ 输入 Configure Display Language → 回车 → 在弹出列表中选 zh-cn → 重启窗口。注意:直接改设置里 locale 字段无效,必须走这个命令流。
常见错误现象:
- 装完插件没反应,以为插件坏了
- 在设置里搜 “language” 改了
display language字段但不生效 - 重启 VSCode 后仍显示英文菜单和提示
Chinese (Simplified) Language Pack 不处理代码内中文注释翻译
这个插件只负责 UI 翻译,对代码里的中文注释、字符串、变量名完全无影响。有人误以为它能“翻译注释”,结果发现 // 初始化用户配置 还是原样显示——这很正常,它本就不干这事。
如果真需要注释翻译,得额外装独立插件,比如 Comment Translate,但它依赖第三方翻译 API(如有道),且需手动配置 commentTranslate.source 和 commentTranslate.targetLanguage。不建议默认开启,容易拖慢编辑器响应速度,尤其在大文件中悬停时明显卡顿。
中文输入法与快捷键冲突时优先调 editor.action.formatDocument
用中文输入法打字时,Shift+Alt+F 或 Alt+Shift+F 容易被系统拦截成中英文切换,导致格式化失败。这不是插件问题,是操作系统级输入法劫持。
解决办法不是换输入法,而是改用命令面板触发:
-
Ctrl+Shift+P→ 输入Format Document→ 回车 - 或者绑定一个无冲突的快捷键,比如
Ctrl+K Ctrl+F(默认已存在,且极少被中文输入法占用) - 检查
settings.json中是否误启用了editor.formatOnSave却没配好prettier或eslint,否则保存时无声失败,你以为格式化没起作用
拼写检查插件 Code Spell Checker 对中文变量名默认放行
它只校验英文单词,userName、userNamme 会标红,但 用户名、用户名称 完全不报错——这是设计如此,不是 bug。
如果你在 TypeScript 项目里混用中文变量名,想靠它防低级错,会失效。真正有用的方案是:
- 用
eslint配@typescript-eslint/naming-convention规则强制变量名英文 - 把
Code Spell Checker的cSpell.language设为en, zh,它才开始查中文词典里的常用词(比如 “接收” vs “接受”),但对驼峰命名无意义 - 别指望它发现
useEffect拼成useEffct——那是 TypeScript 类型检查该管的事
真正容易被忽略的是:插件默认启用 “检查字符串字面量”,但大型项目里大量 i18n 键名(如 "common.ok")会被当成拼写错误标红。得在 cSpell.words 里手动加白名单,或者关掉 cSpell.checkLimit 避免卡顿。











