根本原因是未执行Configure Display Language命令——该命令是VS Code 1.70+唯一合法路径,其他操作(改settings.json、Reload、手动写locale.json)均无效;必须安装官方包ms-ceintl.vscode-language-pack-zh-hans,通过命令面板输入全名、选zh-cn、点Restart才能生效。

VSCode 设置中文包后无法无缝切换,根本原因不是“没装对”,而是“没走对路径”——官方只认 Configure Display Language 这一条命令,其他任何操作(改 settings.json、点 Reload、手动写 locale.json)在 VS Code 1.70+ 版本中都只是临时补丁,重启即失效。
必须安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans
第三方插件如 Chinese Language Pack 或带 “Pro” 字样的汉化包,会导致命令面板乱码、报错 Cannot read property 'translate' of undefined,甚至覆盖本地语言配置。唯一合法路径是:
- 按
Ctrl+Shift+X打开扩展面板,搜索完整名称Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者为 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 点击 Install 后,**必须等右下角弹出提示,且点 “Change and Restart”**;仅点 “Reload” 不生效
Configure Display Language 命令必须输全名并选 zh-cn
该命令不是可选项,而是唯一写入生效配置的入口。常见错误包括:
- 输成
configure language、set language或漏掉空格,命令面板不识别 - 在下拉列表中选 “Chinese (Simplified)” —— 无效,必须选代码值
zh-cn(小写 + 短横线,zh_CN、Zh-cn、Chinese全部失败) - 选完后弹窗提示 “Restart window?”,必须点 Yes;点 “No” 或关闭弹窗,
locale.json不会生成或更新
远程开发(SSH/WSL)下中文不生效,是因为 locale 配置没同步到服务端
本地设好中文,连上 Remote-SSH 或 WSL 后界面仍是英文?因为 VS Code Server 在远程机器上独立运行,它读的是远程路径下的 locale.json,而非你本地的配置。
- Windows 本地路径:
%APPDATA%\Code\User\locale.json - Linux/macOS 远程路径:
~/.config/Code/User/locale.json - 解决方法:在远程实例中重复执行
Configure Display Language→ 选zh-cn→ 重启远程窗口;或者手动在远程机器上创建locale.json,内容为{"locale":"zh-cn"}
部分菜单/插件仍显示英文,这不是设置失败,而是正常现象
VS Code 本体语言切换只影响核心 UI(菜单栏、侧边栏、命令面板、设置页),不强制汉化第三方插件。例如:
-
Python、Remote-SSH、GitLens等插件的界面语言由各自维护,需单独查看其文档是否支持中文 - 某些插件即使支持,也要等其主动适配新版本的 VS Code 语言 API,滞后是常态
- 文件内容编码(如
GBK)、终端字体(未配Microsoft YaHei UI)也会导致“看起来像没切成功”,但实际只是渲染问题
最常被忽略的一点:VS Code 的语言切换是进程级的,不是会话级的。哪怕你改了 locale.json,只要没触发全新进程启动(即完整重启),就不会读取新值。很多人卡在这一步,反复 reload 却始终是英文界面。


















