VSCode插件管理界面中文显示需安装Microsoft官方Chinese (Simplified) Language Pack插件,并执行Configure Display Language命令选择zh-cn后彻底重启;仅装插件或选错locale值(如zh、zh_CN)均无效,远程环境还需在对应实例中重复配置。

只装一个插件:官方 Chinese (Simplified) Language Pack for Visual Studio Code
VSCode 插件管理界面(扩展面板)的中文显示,不靠第三方“汉化插件”,只依赖微软官方语言包。其他名字含“中文”“汉化”“Pro”的插件,比如 Chinese Language Pack(作者 13xforever)或 VSCode Chinese,2024 年后已停止更新,新版 VSCode 1.80+ 直接忽略加载,装了也白装。
认准唯一有效插件:
- 全名必须是
Chinese (Simplified) Language Pack for Visual Studio Code(括号、空格、大小写都要一致) - 发布者必须显示为
Microsoft(不是 “Microsoft Corporation” 或其他变体) - ID 必须是
ms-ceintl.vscode-language-pack-zh-hans(可在扩展详情页底部看到)
安装后,插件管理界面本身不会立刻变中文——它只是“备好了翻译字典”,还没告诉 VSCode 用哪本字典。
Configure Display Language 命令必须选 zh-cn,不是 zh 或 zh-CN
命令面板里输 Configure Display Language,选中后弹出的列表里,要手动点 zh-cn 这个值。注意:
-
zh、zh_CN、Chinese (Simplified)文字项都不生效 - 大小写不敏感,但连字符
-是强制要求,下划线_或空格都无效 - 选完必须点 “Restart”,不是 “Reload Window”——重载窗口不重载语言配置,右下角仍显示
en
验证是否生效,只看三处:文件 / 编辑 / 视图 顶部菜单栏、Ctrl+Shift+P 输入框上方提示、Ctrl+, 设置页左侧导航栏。插件管理界面(Ctrl+Shift+X)会同步变中文。
离线安装或批量部署时,.vsix 文件必须匹配架构和 VSCode 版本
内网或无网络环境不能直接搜插件,得手动装 .vsix 包。常见失败不是因为“没装上”,而是包本身不兼容:
- 下载地址必须来自官网,文件名形如
MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix - 解压后打开
package.json,检查"engines": {"vscode": "^1.90.0"}中版本号,与本地code --version输出第一段(如1.90.2→ 取1.90)严格匹配 - ARM Mac 用户必须下载含
darwin-arm64的版本;x64 Windows 必须用win32-x64版本,混用直接报Extension is not compatible - 路径含中文、空格或特殊符号(如
C:\Users\张三\Desktop\zh.vsix)会导致code --install-extension报ENOENT,移到纯英文路径再试
插件管理界面仍为英文?优先查 locale.json 而非 settings.json
当命令面板打不开、Configure Display Language 不出现 zh-cn 选项,或反复切换无效时,直接改配置文件最稳。但注意:
- 不是改
settings.json,而是改locale.json(路径如下) - Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json - 文件内容必须是合法 JSON,仅一行:
{"locale":"zh-cn"}(双引号、冒号、逗号全为英文符号) - 保存后,必须从任务管理器结束所有
Code.exe进程(Windows)或 Activity Monitor 杀掉全部 Code 进程(macOS),再双击图标重开
真正容易被忽略的是:Remote-SSH / WSL / Containers 场景下,只在本地装插件没用——语言包必须在远程环境中也安装并配置 locale.json,否则插件管理界面在远程窗口里仍是英文。


















