必须安装Microsoft官方中文语言包、执行Configure Display Language命令选zh-cn、并彻底重启;装第三方插件、改settings.json或仅重载窗口均无效。

装对插件:只认 Microsoft 官方语言包
VS Code 的中文界面不是靠“汉化补丁”,而是靠官方语言资源包 + 正确加载机制。第三方插件如 Chinese Language Pack、VSCode Chinese 或任何带“Pro”“Ultimate”字样的扩展,都会导致命令面板乱码、报错 Cannot read property 'translate' of undefined,甚至禁用部分核心功能。
必须安装且仅安装这一项:Chinese (Simplified) Language Pack for Visual Studio Code,发布者为 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角会弹出 Restart Now 提示——此时先别点,继续下一步配置。
切对 locale:zh-cn 是唯一有效值
Configure Display Language 命令不是可选项,是激活中文的唯一入口。它不改设置,而是生成或更新 locale.json 文件。这个命令只接受严格格式:zh-cn(全小写、短横线、无空格),其他任何变体都无效:
-
zh_CN、ZH-CN、zh-hans、Chinese→ 无报错,但静默失败,维持英文 -
zh或漏掉引号 → JSON 解析失败,回退到默认语言 - 在
settings.json里写"locale": "zh-cn"→ VS Code 1.70+ 已移除该字段支持,完全忽略
执行方式:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入完整命令名,从下拉列表中明确选择 zh-cn,再点提示里的 Restart(不是 Reload Window)。
找对路径:locale.json 必须放在用户级目录
VS Code 只读取特定位置的 locale.json,其他路径写的配置一概不生效。文件必须是 UTF-8 无 BOM 编码,内容仅一行:
{"locale":"zh-cn"}
正确路径如下:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - 便携版:
[安装目录]/data/user-data/User/locale.json
若多个路径下存在 locale.json(比如工作区或系统级目录),删掉非用户级的,避免覆盖。用 VS Code 自己新建并保存该文件,右下角状态栏确认编码显示为 UTF-8,而非 GBK 或 UTF-8 with BOM。
彻底重启:后台进程没关干净 = 白配
点 Restart 提示或执行 Developer: Reload Window 都不够。语言环境是在主进程启动时加载的,只重载窗口不会重新读取 locale.json。
必须完全退出所有 VS Code 进程:
- Windows:打开任务管理器,结束全部
Code.exe进程(包括后台服务、GPU 进程、渲染器等) - macOS:活动监视器中搜索
Code,结束所有Electron和Code Helper进程 - Linux:运行
pkill -f code
托盘图标还在、终端里还有 code 子进程,就代表没关干净。重新启动后,验证点不是“菜单栏变中文”,而是看设置页左侧导航是否为“用户”“工作区”,搜索框占位符是否为“搜索设置”——这些才是真实生效信号。
真正容易被忽略的是:Remote-SSH / WSL 环境需要单独配远程机器上的 locale.json;集成终端里 node、python 的报错仍为英文属正常,它们不走 VS Code 的 locale 控制链。


















