插件界面仍是英文,是因为未安装microsoft官方中文语言包ms-ceintl.vscode-language-pack-zh-hans、未执行configure display language命令设locale为"zh-cn"、或未在正确路径下配置utf-8无bom的{"locale":"zh-cn"},三者缺一不可。

插件界面仍是英文?没装对官方语言包
插件界面(比如扩展面板里每个插件的描述、配置项、README)不显示中文,大概率是因为装了非官方“中文插件”。VS Code 的插件界面翻译依赖于语言包提供的本地化资源,而只有 ms-ceintl.vscode-language-pack-zh-hans 这个扩展能提供完整、同步更新的简体中文翻译。
常见踩坑点:
- 在扩展市场搜“中文”“汉化”,随手点了
Chinese Language Pack或VSCode Chinese—— 这些不是 Microsoft 发布的,不维护、不翻译插件界面,有的还会覆盖设置导致乱码 - 装了多个语言包冲突,比如同时装了繁体、简体、日文包,VS Code 只认 locale.json 里指定的那一个,其他包的翻译资源不会加载
- 插件本身没做国际化(i18n),即使语言包装对,它的配置页仍显示英文——这是插件作者的责任,不是你的配置问题
Configure Display Language 命令必须执行
只装语言包,插件界面不会自动变中文。VS Code 启动时读取的是 locale.json 文件里的 "locale" 字段,它默认是 "en"。你必须手动告诉 VS Code:“请用简体中文渲染所有界面”,这个动作只能通过 Configure Display Language 命令完成。
操作要点:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并选择Configure Display Language - 在弹出列表中**只点
zh-cn**(小写、短横线、不能是zh_CN、zh-hans、Chinese) - 选完后必须点提示里的
Restart,不是Developer: Reload Window—— 后者不重载语言环境,插件界面仍为英文
locale.json 路径和内容不能错一字符
VS Code 只读取用户级 locale.json,且对格式极其敏感。哪怕多一个空格、少一个引号、用了 UTF-8 BOM,都会静默失败,右下角状态栏持续显示 en。
确认三件事:
- 路径必须准确:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容必须严格为一行合法 JSON:
{"locale":"zh-cn"}(无换行、无注释、无多余字段) - 编码必须是 UTF-8 无 BOM;用记事本保存时选“UTF-8”,别选“UTF-8 with BOM”
Remote-SSH / WSL 插件界面还是英文?本地设置无效
你在本地把 VS Code 设置成中文,但连上 WSL 或 Remote-SSH 后,插件界面又变英文——这是因为远程实例运行的是独立的 VS Code Server,它不读你本地的 locale.json,而是读远程机器上的同名文件。
解决方法:
- 先确认远程服务已启动:在 WSL 终端或 SSH 会话中运行
code --list-extensions - 进入远程配置目录:
~/.vscode-server/data/Machine/下某个哈希命名的子目录(如xxx...) - 在该目录下创建或编辑
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后,在**远程窗口内**执行
Developer: Reload Window(不是本地窗口)
远程环境里没有图形界面、不支持命令面板调用 Configure Display Language,所以必须手动写文件,而且路径不能错——~/.vscode-server 是唯一有效位置,~/.config/Code/User 在远程环境下不被读取。











