确认安装的是 microsoft 官方中文语言包:必须为 chinese (simplified) language pack for visual studio code,发布者 microsoft,id ms-ceintl.vscode-language-pack-zh-hans,图标含蓝白 vs code logo 与“中”字,下载量超千万;搜 @installed 确认已安装;locale.json 内容仅 {"locale":"zh-cn"}(utf-8 无 bom);remote-ssh/wsl 需在远程 ~/.vscode-server/data/machine/ 下配置;snap/flatpak 版本不兼容,须换 .deb 或 tarball;生效三要素:插件正确安装、locale.json 合法、进程全新启动;状态栏显示 zh-cn 才成功。

怎么确认装的是 Microsoft 官方中文语言包
搜“中文插件”“汉化包”大概率装错——第三方扩展图标模糊、描述含糊,有的带广告,甚至导致命令面板乱码或报错 Cannot read property 'translate' of undefined。真正有效的只有 Microsoft 官方发布的那一款:
- 全名必须是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft,扩展 ID 是ms-ceintl.vscode-language-pack-zh-hans - 图标是蓝白 VS Code logo + 中文“中”字,下载量超 1000 万次(可作为辅助判断)
- 在扩展面板里搜
@installed,确认状态为Installed而非Installing或灰色禁用
Configure Display Language 命令无效怎么办
这个命令本质就是打开并编辑 locale.json,如果命令面板搜不到、空白、卡死,说明语言包没真正加载成功,或 VS Code 没读到配置路径。这时候直接改文件更稳:
- 先彻底关闭所有 VS Code 窗口,包括托盘进程(Windows 查任务管理器中的
Code.exe,macOS 查Electron) - 定位
locale.json文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 用 VS Code 自己打开该文件,写入且仅写入一行:
{"locale":"zh-cn"}(注意:小写、短横线、双引号、UTF-8 无 BOM) - 不能写成
zh_CN、zh-hans、Chinese或zh,这些全部无效
Remote-SSH / WSL 环境下中文不生效
本地设了中文,远程连接后还是英文?因为 Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它读的是远程机器上的 locale.json,和本地完全无关:
- 先在远程终端执行
code --list-extensions,确认语言包已安装在远程环境 - 进入远程配置路径:
~/.vscode-server/data/Machine/(后面可能带哈希后缀目录) - 在该目录下新建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口) - 若用 Snap/Flatpak 安装的 VS Code,语言包大概率无法加载——换用 .deb 或官方 tarball 版本
重启后界面仍是英文,重点排查什么
最常被忽略的不是配置写错,而是进程没关干净,新窗口继承了旧环境。真正的生效条件只有三个:
- 装对插件(
ms-ceintl.vscode-language-pack-zh-hans已Installed) -
locale.json存在且内容合法(只有一行{"locale":"zh-cn"}) - VS Code 进程是全新启动的(不是
Reload Window,必须杀掉后台再开) - 状态栏右下角显示
en就代表没生效;显示zh-cn才算成功
Linux 发行版系统语言设为 zh_CN.UTF-8 但 VS Code 读不到时,硬写 "locale": "zh-hans" 可能更可靠(部分版本接受),但优先试 zh-cn。











