必须安装 microsoft 官方中文语言包并执行 configure display language 命令重启窗口,否则界面无法汉化;远程环境需单独配置 locale.json;snap/flatpak 版本可能不兼容。

装错插件会导致命令面板消失
搜“中文”就点安装,90% 会装到非官方包,比如 Chinese Language Pack 或带 Pro 字样的第三方插件。它们不维护、不兼容,甚至让 Configure Display Language 命令在命令面板里直接消失。
- 必须在扩展面板(
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,或执行后报错Cannot read property 'translate' of undefined
Configure Display Language 命令不是可选项
这个命令才是真正写入语言配置的唯一入口,不是“锦上添花”,而是“必要动作”。只装插件、不执行它,界面永远是英文;手动改 settings.json 里的 "locale": "zh-cn" 也完全无效。
- 按
Ctrl+Shift+P输入Configure Display Language(注意大小写和空格) - 列表里选
zh-cn——不是zh_CN、不是Zh-cn、也不是Chinese - 选完弹窗提示“是否重启窗口”,必须点
Yes,否则配置不加载 - macOS/Linux 用户注意:
Developer: Reload Window不会重新读取 locale 配置,必须彻底退出再启动
远程环境(WSL/SSH)要单独配 locale.json
本地设成中文,连上 WSL 或 Remote-SSH 后还是英文?因为远程实例用的是自己机器上的配置,和本地完全隔离。
- 先确认远程服务已运行:
code --list-extensions能返回列表才算成功 - 进入远程路径:
~/.vscode-server/data/Machine/(后面可能带哈希目录) - 新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口) - 用 Snap/Flatpak 安装的 VS Code 在 Linux 上大概率无法加载语言包,建议换 .deb 或 tarball 版本
验证时别被终端或 Git 输出骗了
终端、调试控制台、Git 提交日志、部分插件弹窗默认不走 VS Code 的 locale 配置,显示英文 ≠ 汉化失败。
- 只盯三个地方:
顶部菜单栏(文件、编辑、视图)、命令面板提示文字(“请输入命令或搜索设置”)、设置界面左侧标签(用户、工作区、扩展) - 如果这三处是中文,说明汉化成功;其余模块属于独立进程,不在语言包覆盖范围内
- 右下角状态栏显示
en就代表没生效,不用看别的
locale.json 存在且内容合法、VS Code 进程是全新启动的。任何一步跳过或做错,都会卡在英文界面。











