必须安装 microsoft 官方简体中文语言包并设 locale 为 zh-cn:搜索 chinese (simplified) language pack for visual studio code(发布者 microsoft),安装后重启;再通过 configure display language 命令选 zh-cn;若失败则手动编辑 locale.json 为 {"locale":"zh-cn"}(utf-8 无 bom)。

装对插件:只认 Microsoft 官方 Chinese (Simplified) Language Pack for Visual Studio Code
搜“中文”“汉化”“chinese”大概率装错——比如 Chinese Language Pack、VSCode Chinese 这类第三方包,它们不维护、翻译残缺,甚至会触发 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 - 安装后右下角弹出 Restart Now 提示——必须点它;只点 “Install” 或 “Reload Window” 不生效
切对语言值:Configure Display Language 命令只认 zh-cn
插件装完 ≠ 界面变中文。它只是“备好了字典”,真正让 VS Code “翻出来”的,是 Configure Display Language 命令。这个命令不认“中文”“简体中文”“zh_CN”“ZH-CN”“zh-CN”,只接受且仅接受小写加连字符的 zh-cn。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Configure Display Language(注意大小写和空格,不能输成configure language) - 从下拉列表中**明确选中
zh-cn** —— 别靠搜索匹配,也别点列表里显示的 “Chinese (Simplified)” 文字项,那只是 UI 提示,真正写入配置的是值 - 弹窗提示重启时,必须点 Restart,不是 “Reload Window”
手动改 locale.json:命令面板失效或反复无效时的兜底方案
如果命令面板打不开、列表没 zh-cn、点了重启还是英文,说明 VS Code 没成功写入或读取语言配置。此时直接编辑 locale.json 是最稳的方式,它绕过 UI 层,强制指定语言,优先级高于所有命令面板操作。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 在活动监视器结束Code Helper;Linux 用pkill -f code - 打开对应路径的
locale.json文件:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容**只能是这一行**:
{"locale":"zh-cn"}(双引号、英文冒号、无空格、无逗号、UTF-8 无 BOM 编码) - 用 VS Code 自己打开并保存该文件,右下角状态栏确认显示
UTF-8,不是GBK或UTF-8 with BOM
验证是否真生效:别被终端和插件界面骗了
顶部菜单栏(文件、编辑、视图)、左侧活动栏 hover 提示、设置界面(Ctrl+,)搜索 locale 显示值为 "zh-cn"——这三处是核心判断依据。终端、调试控制台、Git 输出、部分插件弹窗默认不走 VS Code 的 locale 配置,而是依赖系统 shell 或插件自身本地化逻辑,显示英文是正常现象,不代表汉化失败。
- 远程开发(Remote-SSH / WSL)下仍是英文?因为远程实例运行独立的 VS Code Server,它读的是远程机器上的
locale.json,需在远程环境重复上述步骤 - VS Code 1.70+ 版本已移除
settings.json中的locale字段支持,写进去也无效 - 最常卡住的地方:没彻底退出后台进程、
zh-cn拼错、locale.json编码含 BOM、或误信第三方插件能“一键汉化”











