必须安装microsoft官方插件ms-ceintl.vscode-language-pack-zh-hans,再执行configure display language命令并严格选择zh-cn,最后彻底重启vs code进程,三者缺一不可。

装错插件是中文不生效的首要原因
VS Code 本身不含中文资源,所谓“汉化”全靠 Chinese (Simplified) Language Pack for Visual Studio Code 这个插件提供翻译文件。但搜“中文”“汉化”大概率装到第三方包,比如 Chinese Language Pack 或 VSCode Chinese——它们不维护、不兼容、甚至让命令面板乱码。
必须严格按以下三步操作:
- 按
Ctrl+Shift+X打开扩展面板 - 在搜索框**完整粘贴**:
Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写) - 只安装发布者为
Microsoft、ID 是ms-ceintl.vscode-language-pack-zh-hans的那一项
装完右下角会弹 Restart Now 提示,此时别点 Reload Window,先别关窗口——后面还要执行关键命令。
Configure Display Language 命令必须手动执行且选 zh-cn
语言包只是“备好了字典”,VS Code 默认仍用英文启动。真正切换语言靠的是内置命令 Configure Display Language,它会写入或更新 locale.json 文件,而不是改 settings.json。
常见错误包括输错命令名(比如少字母、大小写不对)、选错 locale 值:
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P) - 输入并选择:
Configure Display Language - 从下拉列表中**严格选择**
zh-cn(小写、短横线;zh_CN、zh-hans、Chinese全无效) - 弹出「是否重启窗口」时,必须点
Restart,Reload Window不重读语言配置
如果命令面板里搜不到这个选项,基本可断定插件没装成功,或没点过右下角的 Restart Now 导致插件未激活。
彻底重启 VS Code 进程,不是“重新加载窗口”
很多人点了 Restart 后发现菜单还是英文,问题往往出在进程没退干净。VS Code 的语言配置只在进程启动时读取一次,热重载或窗口重载不会触发重读。
验证是否真退出:
- Windows:打开任务管理器,确认没有残留的
Code.exe进程 - macOS:用活动监视器查
Electron进程是否全部退出 - Linux:运行
ps aux | grep code,确保无code相关进程
再全新启动 VS Code,右下角状态栏会显示当前语言代码(如 zh-cn),点击它也能快速切换。若仍显示 en,说明前面某步出错了。
locale.json 手动配置是最后兜底手段
当命令面板打不开、或执行了 Configure Display Language 但重启后仍是英文,直接编辑 locale.json 最稳——它绕过了命令执行失败或路径识别异常的问题。
注意两个关键点:
-
locale.json路径不是settings.json:
Windows:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
macOS/Linux:~/.vscode/locale.json - 文件内容只允许一行合法 JSON:
{"locale": "zh-cn"}(双引号、小写、短横线,不能多空格、不能加注释) - 保存后必须关闭所有窗口,并确认后台进程已退出,再重新启动
改 settings.json 加 "locale": "zh-cn" 完全无效——这个字段在那里不被识别。另外,Reset Language Pack 命令偶尔有用,但不如重装官方插件+手动写 locale.json 可靠。











