必须安装microsoft官方中文语言包并执行configure display language命令设locale为"zh-cn"后彻底重启;搜“中文”易装错第三方包,仅认准全名chinese (simplified) language pack for visual studio code、发布者microsoft、id ms-ceintl.vscode-language-pack-zh-hans。

VS Code 插件市场搜“中文”会装错包
直接在扩展面板里搜“中文”“汉化”“简体中文”,90% 以上结果是过时或非官方插件,比如 Chinese Language Pack(作者 13xforever)或 VSCode Chinese,这些在 VS Code 1.80+ 版本中已被弃用,安装后界面仍为英文,且无法通过命令面板切换语言。
真正起效的只有一个:官方语言包 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 固定为 ms-ceintl.vscode-language-pack-zh-hans。搜索时建议直接粘贴全名,避免模糊匹配。
- 别信图标带“中”字但发布者不是
Microsoft的插件 - 别点描述里写“一键汉化”“深度破解”的第三方包
- 扩展详情页底部必须能看到 ID 字段为
ms-ceintl.vscode-language-pack-zh-hans
安装后界面仍是英文?关键在 Configure Display Language 命令
装完插件 ≠ 界面变中文。插件只是提供翻译资源,VS Code 默认仍用英文 locale。必须显式执行语言切换命令,否则右下角弹窗里的 Reload Window 也无效——它不重载语言配置。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language - 在弹出的
locale.json中把"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号,zh_CN或zh-hans都不识别) - 保存后务必点弹窗里的
Restart按钮,或手动关闭所有窗口 + 杀掉后台进程再重开
命令面板失效时,直接编辑 locale.json 最可靠
如果 Configure Display Language 命令搜不到、列表为空、或改完不生效,说明 VS Code 没读到正确路径的配置文件,此时跳过 UI 层,直改文件更稳。
- 先彻底关闭所有 VS Code 窗口(Windows 可查任务管理器是否有残留
Code.exe) - 用任意文本编辑器打开对应路径的
locale.json:
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只写一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码 - 重启 VS Code,界面立即响应
Remote-SSH / WSL 环境下中文不生效?插件要装在远程端
如果你用 Remote-SSH、WSL 或 Dev Containers,本地装的语言包对远程界面无效。VS Code 的 UI 语言由当前运行环境决定——远程窗口的菜单、设置项等,依赖的是远程机器上安装的插件和 locale.json。
- 连接远程后,在远程窗口中再次打开扩展面板(
Ctrl+Shift+X),重新安装Chinese (Simplified) Language Pack for Visual Studio Code - 再执行一次
Configure Display Language命令,或直接编辑远程端的locale.json - 确认远程端路径是否被企业策略锁定(如环境变量
VSCODE_LANG=en),这种情况下改文件也无效,需先解除策略
语言包本身不覆盖全部 UI,调试器、终端、部分设置项仍为英文,这是正常现象——官方语言包覆盖率约 85%,不必强求 100% 汉化。补全可用 Chinese Menu 这类辅助插件,但它们不能替代 ms-ceintl.vscode-language-pack-zh-hans。











