插件管理界面显示英文是因为 locale.json 配置未生效或错误——它必须严格位于用户级路径、内容为 {"locale":"zh-cn"}(小写短横线)、无格式错误,且远程开发需在远程机器对应路径单独配置并安装中文语言包。

VSCode 插件管理界面(Extensions 视图)显示英文,不是插件没装中文包,而是 locale 设置没生效或被覆盖——插件市场本身不单独汉化,它完全依赖全局 locale.json 配置。
为什么插件管理页还是英文?
插件管理界面(Ctrl+Shift+X 打开的 Extensions 页)的文本(如“Install”“Disable”“Search extensions”“No extensions found”)全部来自 VS Code 主语言包,不是某个插件自带的翻译。它不会读 settings.json,也不认系统语言,只认用户级 locale.json 文件是否正确存在且内容合法。
- 常见错觉:以为装了“中文插件”就自动汉化整个 UI,其实那个插件只是提供翻译资源,不触发加载
- 真实原因:要么
locale.json不存在,要么内容格式错误(比如多空格、用单引号、写成{"locale": "zh-CN"}),要么路径放错了(比如放在项目.vscode/locale.json下) - 特别注意:远程开发(WSL / Remote-SSH)下,插件管理页显示英文,大概率是远程机器上缺
locale.json,本地设置完全无效
Configure Display Language 命令失效怎么办?
该命令本应自动生成正确的 locale.json,但若执行后插件页仍英文,说明它没成功写入或被其他配置覆盖:
- 先确认命令面板里输入的是
Configure Display Language(全名,不能少字母,不能拼错) - 执行后必须从弹出列表中明确点击
zh-cn(小写、短横线;zh_CN、zh-hans、Chinese全部无效) - 如果列表里根本没有
zh-cn,说明官方语言包未安装或损坏,需先去扩展页搜Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans) - 执行命令后没弹出重启提示?说明
locale.json所在目录权限不足(尤其 macOS/Linux 上的~/.config/Code/User/),可手动创建并写入{"locale":"zh-cn"}
远程开发(WSL / Remote-SSH)插件页仍是英文
Remote-SSH 和 WSL 启动的是独立的 VS Code Server 实例,它完全不读你本地的 locale.json,而是读远程机器上的对应路径:
- 连接到远程后,在终端运行:
code --list-extensions确认服务已启动 - 进入远程路径:
~/.vscode-server/data/Machine/(后面是哈希目录名,如abc123...) - 在该目录下新建或编辑
locale.json,内容严格为一行:{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口!) - 注意:远程机器上也必须已安装官方中文语言包(可通过
code --install-extension ms-ceintl.vscode-language-pack-zh-hans安装)
最常被忽略的点:插件管理界面的语言和编辑器主界面语言绑定在同一套机制里,但它的响应更敏感——locale.json 里一个多余的空格,或者远程路径写错一级,就会导致插件页卡在英文不动,而其他菜单看起来还正常。检查时优先打开输出面板(Ctrl+Shift+U → 选 Log (Window)),搜索 zh-cn,看是否有 Loaded locale zh-cn from ... 日志。没有?说明加载根本没发生。


















