必须安装微软官方语言包、执行configure display language命令选zh-cn、彻底重启所有进程;确认方法:扩展id为ms-ceintl.vscode-language-pack-zh-hans,发布者是microsoft,全名严格为chinese (simplified) language pack for visual studio code。

VS Code 设置中文界面不是装个插件就完事,必须同时满足三个硬性条件:安装微软官方语言包、执行 Configure Display Language 命令并选 zh-cn、彻底重启所有进程;缺一不可,否则永远显示英文。
怎么确认装的是 Microsoft 官方中文语言包?
搜“中文”“汉化”“chinese”大概率装错——第三方插件名字相似但发布者不是 Microsoft,它们不翻译菜单栏、命令面板,还可能带广告或乱码。只认一个 ID:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft,全名必须严格输入:Chinese (Simplified) Language Pack for Visual Studio Code(注意括号、空格、大小写)。
安装后右下角会弹出提示,此时不要点“Reload window”,它不触发语言切换。
- Windows/macOS/Linux 都用
Ctrl+Shift+X(或Cmd+Shift+X)打开扩展面板 - 搜索框里逐字粘贴全名,别缩写、别漏括号
- 认准图标:蓝白 VS Code logo + 中文“中”字标识
- 如果搜不到,说明 VS Code 版本低于 1.13,需先升级
Configure Display Language 命令为什么总没反应?
这个命令才是激活中文的开关,不是可选项。它本质是生成或修正 locale.json 文件,手动改 settings.json 或加启动参数都无效。
常见失败原因:
- 命令面板里输错关键词,比如搜
language setting或zh-cn—— 必须输全称:Configure Display Language - 列表里点了“简体中文”文字项,但真正生效的是代码项
zh-cn(小写、短横线,不是zh_CN或zh-hans) - 点了 Restart 后只关了当前窗口,后台
Code.exe(Windows)、Electron(macOS)或code(Linux)仍在运行,新窗口复用旧环境 - 命令面板根本搜不到该命令 → 说明语言包没装成功,或装完没彻底重启过任何窗口
手动编辑 locale.json 的正确姿势
当命令面板卡死、UI 崩溃或批量部署时,直接改配置文件最可靠。但这个文件极其敏感,路径、格式、编码错一个字符就静默失效。
三要素必须全部满足:
-
路径必须准确:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:~/Library/Application Support/Code/User/locale.json
– Linux:~/.config/Code/User/locale.json -
内容只能是单行合法 JSON:
{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无注释、无 BOM) -
不能放在工作区目录(如
.vscode/locale.json),也不能混在settings.json里
改完后必须完全退出 VS Code(包括后台进程)再重新启动,仅“重载窗口”无效。
为什么插件界面/终端/调试控制台还是英文?
这不是设置错了,而是设计如此:
- 菜单栏、侧边栏、命令面板(
Ctrl+Shift+P)、设置页(Ctrl+,)能完全汉化 - 集成终端(
Ctrl+`)、Git 输出、调试控制台(Debug Console)属于 Electron 子进程,不继承主窗口的locale设置,天生显示英文 - 插件是否显示中文,取决于它自己是否内置
package.nls.zh-cn.json并调用vscode.env.language—— 官方语言包不负责翻译插件,比如 Prettier、ESLint 默认就是英文 - Remote-SSH / WSL 环境下,本地设了
zh-cn,远程端仍为英文 → 必须在远程机器的~/.vscode-server/data/Machine/xxx/locale.json里也写入{"locale":"zh-cn"}
最容易被忽略的其实是“彻底关进程”——很多人点完 Restart Now 又立刻开新窗口,旧进程还在后台跑,locale.json 根本没加载。关干净再启动,才是最稳的一步。











