必须执行 Configure Display Language 命令并选择 zh-cn 后重启,因插件仅提供翻译资源而不自动激活;locale.json 需位于用户目录且内容严格为 {"locale": "zh-cn"};远程开发需单独配置远程端 locale.json 并重载窗口。

Configure Display Language 命令没执行或选错值
装了 Chinese (Simplified) Language Pack for Visual Studio Code 但界面仍是英文,90% 是因为跳过了这一步——插件只提供翻译资源,不自动激活。VS Code 启动时只读取 locale.json 中的 "locale" 字段,它默认是 "en"。
- 必须用
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板,输入并完整执行Configure Display Language(不是Change Language或模糊匹配项) - 在下拉列表中明确选择
zh-cn(不是zh、zh-hans、Chinese,也不是zh_CN) - 弹出提示后必须点 Restart,仅关闭窗口再手动打开无效——后台残留的
Code Helper进程会继承旧语言环境
locale.json 文件路径错误、格式非法或被覆盖
VS Code 只认用户级 locale.json,且只接受严格 JSON 格式。写错位置、手动生成、或内容含多余字符,都会导致静默回退英文。
- 正确路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须是且仅是:
{"locale": "zh-cn"}(双引号、冒号后有空格、值全小写、短横线) - 如果该文件已存在但值为
"en"或为空,大概率是工作区.vscode/settings.json、远程开发配置、或企业策略插件写入了冲突值;临时关闭文件夹(File > Close Folder)后再执行命令可绕过干扰
远程开发(SSH/WSL/Dev Container)下中文失效
本地设好了,连上 Remote-SSH 或 WSL 后界面又变英文?这不是 bug,是设计如此:远程实例运行的是独立的 VS Code Server,读取的是远程机器上的 locale.json,和本地完全无关。
- 需登录远程环境,在对应路径(如
~/.config/Code/User/locale.json)下新建或编辑该文件,内容仍为{"locale": "zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是 reload 本地窗口) - 若远程端未安装中文包,需先在远程扩展面板中安装
Chinese (Simplified) Language Pack,否则即使locale.json正确也无翻译资源可用
终端和调试控制台仍是英文
菜单、设置页、命令面板都中文了,但 Terminal 和 Debug Console 还是英文?这是正常现象——它们属于 Electron 独立子进程,不继承主窗口的 locale 设置,其语言由系统环境变量或启动参数决定。
- 终端语言取决于 shell 的
LANG或LC_ALL环境变量(例如 Linux/macOS 下运行export LANG=zh_CN.UTF-8) - 调试控制台语言无法通过 VS Code 配置切换,它直接使用 Node.js 运行时的语言环境
- 不要试图在
settings.json里加"locale"字段去“修复”它——这个字段对终端和调试器完全无效
最常被忽略的点是:VS Code 的语言切换和插件启用是两套独立机制。即使禁用了所有其他插件,只要没运行 Configure Display Language 并彻底重启,中文就不会出现——这不是 Bug,是设计如此。











