官方唯一可用中文语言包是ms-ceintl.vscode-language-pack-zh-hans,需配合手动修改locale.json中"locale": "zh-cn"并重启生效,其他汉化插件已停更且不兼容新版。

只认准官方 ID:ms-ceintl.vscode-language-pack-zh-hans
VSCode 插件市场里搜“中文”“汉化”“简体中文”,出来的结果至少有二十个,但真正能用、能长期维护的只有一个:ms-ceintl.vscode-language-pack-zh-hans。它由 Microsoft 官方发布,ID 固定、图标固定(蓝白 VS Code logo + 中文“中”字)、发布者字段必须是 Microsoft(注意不是 Microsoft Corporation 或其他变体)。其他所有带“Pro”“Ultimate”“汉化增强版”“一键全汉化”的插件,包括 Chinese Language Pack(作者 13xforever)和 VSCode Chinese,2024 年起已停止更新,VS Code 1.80+ 版本直接拒绝加载——装了不仅没效果,还可能干扰 locale 配置读取。
装完不生效?不是插件问题,是没走对配置路径
安装插件只是“备好翻译资源”,VS Code 默认仍用英文界面。必须手动触发语言切换:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在打开的
locale.json文件中,把"locale": "en"改成"locale": "zh-cn"(必须小写、短横线、双引号包裹) - 保存后,弹窗点
Restart—— 不要点Reload Window,它不重载语言配置
改错格式如 "zh_CN"、"zh"、"Chinese" 全部无效;改完不重启,或只重载窗口,界面一定还是英文。
locale.json 路径和覆盖优先级容易搞错
VS Code 只从特定路径读取 locale.json,且按固定优先级生效:工作区 > 用户 > 系统。绝大多数人只需改用户级配置,但路径常被写错:
- Windows:
%APPDATA%\Code\User\locale.json(不是settings.json,也不是Code - Insiders目录) - macOS:
~/Library/Application Support/Code/User/locale.json(注意拼写是locale,不是local) - Linux:
~/.config/Code/User/locale.json
如果工作区根目录下也有 .vscode/locale.json,它会覆盖用户级设置——这点常被忽略,导致你在用户配置里改了,但打开某个项目时界面仍是英文。
菜单汉化不全是正常现象,别硬凑补丁插件
官方语言包覆盖率约 85%,调试器、终端、部分设置项、GitLens 等第三方插件界面仍为英文,这是设计使然,不是 bug。强行装 Chinese Menu 或 vscode-zh-hans-menu 只能补右键菜单或个别设置项,无法统一底层翻译逻辑,还可能与新版 VS Code 冲突。真遇到关键功能没汉化,建议直接查英文文档关键词(比如 breakpoint、watch expression),比依赖不稳定的补丁更可靠。











