应安装官方简体中文语言包 ms-ceintl.vscode-language-pack-zh-hans,搜索时需输入完整名称“chinese (simplified) language pack for visual studio code”,发布者必须为 microsoft,图标为蓝白 vs code logo 加红色“中”字,id 必须为该值;安装后需通过命令面板执行 configure display language,将 locale.json 中 "locale": "en" 改为 "locale": "zh-cn"(小写、短横线、双引号),保存后点击 restart 重启生效;路径按系统区分:windows 为 %appdata%\code\user\locale.json,macos 为 ~/library/application support/code/user/locale.json,linux 为 ~/.config/code/user/locale.json;若状态栏 locale 灰色不可编辑,则可能被企业策略或 vscode_lang 环境变量锁定;菜单汉化覆盖率约 85%,部分界面仍为英文,可辅以 chinese menu 等插件但不可替代官方包。

只装一个:官方简体中文语言包 ms-ceintl.vscode-language-pack-zh-hans,其他所有带“汉化”“Pro”“Ultimate”字样的插件都不用装,装了反而可能失效。
认准官方插件的三个硬指标
搜索时必须输入完整名称 Chinese (Simplified) Language Pack for Visual Studio Code,不能搜“中文插件”或“chinese language”。结果页只看三项:
- 发布者字段严格显示
Microsoft(不是Microsoft Corporation或其它变体) - 图标是蓝白 VS Code logo + 红色“中”字
- 扩展详情页底部 ID 明确为
ms-ceintl.vscode-language-pack-zh-hans
常见踩坑:装了 Chinese Language Pack(作者 13xforever)或 VSCode Chinese,这些 2024 年后已停止维护,VS Code 1.80+ 版本直接不加载。
安装后仍是英文?不是插件没装好,是没触发语言切换
插件只是“备好字典”,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 - Linux:
~/.config/Code/User/locale.json
如果右下角状态栏点 locale 显示灰色不可编辑,说明被企业策略或环境变量(如 VSCODE_LANG=en)强制锁定——此时手动改文件也无效,得先解除策略或变量。
菜单汉化不是 100% 覆盖,官方语言包实际覆盖率约 85%,调试器、终端、部分设置项仍为英文。补全可用 Chinese Menu 或 vscode-zh-hans-menu,但它们只是辅助,不能替代官方包。











