必须手动设locale为zh-cn,装中文包后界面仍英文是因为vscode未读取配置;官方语言包仅提供翻译资源,不自动启用,需通过configure display language命令或在settings.json中添加"locale": "zh-cn"并彻底重启进程。

VSCode汉化必须手动设locale为zh-cn
装了中文语言包但界面还是英文?不是插件没生效,而是VSCode根本没“读取”它。官方语言包只提供翻译资源,不自动切换——locale这个配置项默认是空或en,必须显式写死为zh-cn(注意连字符,大小写不敏感但2026版起推荐全小写)。
常见错误包括:
- 在命令面板输
Configure Language或Change Language——正确命令名是Configure Display Language - 选语言时点
Chinese或zh——有效值只有zh-cn,其他选项不会写入配置 - settings.json里写
"locale": "zh-CN"——新版VSCode会忽略大写CN,必须用zh-cn
最稳路径:按Ctrl+Shift+P → 输入Open User Settings (JSON) → 在{}里加一行"locale": "zh-cn" → Ctrl+S保存 → 从任务管理器结束所有Code.exe进程 → 再双击图标启动。
中文菜单不全?右键和设置项仍英文是正常现象
官方Chinese (Simplified) Language Pack汉化覆盖率约85%,顶部菜单、命令面板、设置页左侧导航栏这三处是核心验证区;终端、调试控制台、Git输出面板等模块使用独立本地化逻辑,保持英文属设计如此,不是故障。
如果确实需要补全右键菜单或深层设置项,可额外安装两个轻量插件:
-
Chinese Menu:专治右键上下文菜单汉化 -
vscode-zh-hans-menu:覆盖更多设置页内嵌文本和提示
注意:这两个插件不替代官方语言包,仅作补充,且无需重启,启用后立即生效。
插件冲突导致汉化失效或启动卡顿
汉化本身不耗资源,但某些插件会在启动时抢夺UI线程,导致locale加载延迟甚至失败。典型组合是Prettier + ESLint + GitLens全开,尤其在大型工作区中。
建议分层启用:
- 基础层(必开):
Chinese (Simplified) Language Pack、vscode-icons(文件图标)、Path Intellisense(路径补全) - 开发层(按需):
ESLint和Prettier必须配eslint-config-prettier和eslint-plugin-prettier,否则格式化会打架 - 观察层(慎开):
GitLens建议关闭gitlens.advanced.heatmap.enabled等高开销功能,避免拖慢初始化
验证方法:禁用所有插件 → 单独启用中文语言包 → 确认汉化稳定 → 再逐个启用其他插件,卡顿时立刻回退。
终端里code --install-extension命令失效怎么办
当VSCode自身卡死、命令面板打不开,或反复切换locale无效时,终端直连是最可靠兜底方式。这不是高级操作,而是2026年标准维护手段。
执行以下任一命令即可强制刷新语言包依赖:
-
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(适用于已安装但未激活) -
code --uninstall-extension MS-CEINTL.vscode-language-pack-zh-hans && code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(彻底重装)
执行后仍需配合locale配置和进程重启,单靠命令不能跳过这步。另外注意:该命令对远程SSH或WSL环境同样有效,但需确保code命令已加入PATH。
真正卡住的点从来不是“怎么装插件”,而是locale没写对、进程没杀干净、或者多个插件在后台争抢UI线程——这些地方不细看日志,光靠重启很难根除。











