必须安装微软官方语言包ms-ceintl.vscode-language-pack-zh-hans并手动配置locale.json为{"locale":"zh-cn"}后完全重启VS Code才能实现汉化,其他插件无效且新版不兼容。

只装 Microsoft 官方 ms-ceintl.vscode-language-pack-zh-hans
VS Code 汉化不是“装个中文插件就变中文”,而是必须用微软官方语言包——ms-ceintl.vscode-language-pack-zh-hans。其他所有名字带“中文”“汉化”“Pro”“Ultimate”的插件,哪怕下载量高、图标像,都不是微软维护,2024 年后已停止更新,新版 VS Code 1.80+ 直接拒绝加载。
认准方式只有三个硬指标:
- 发布者必须是 Microsoft(不是 Microsoft Corporation、MS Corp 或空字段)
- 扩展 ID 必须是
ms-ceintl.vscode-language-pack-zh-hans(在扩展详情页底部可见) - 图标是蓝白 VS Code logo + 中文“中”字
搜索时务必粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code,别搜“中文插件”或“chinese language”,否则首页全是仿冒包。
Configure Display Language 命令才是切换关键
装完插件界面仍是英文?正常。插件只是“备好了翻译字典”,VS Code 默认仍用英文界面,必须显式触发语言切换。
操作路径很固定:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language(注意:不是“Change Language”或“Set Language”) - 在弹出的
locale.json文件里,把"locale": "en"改成"locale": "zh-cn" - 保存后,弹窗点 Restart —— 不要点 Reload Window,它不重载语言配置
常见错误格式:"zh_CN"、"zh-hans"、"Chinese"、"zh" 全部无效;大小写、连字符、双引号缺一不可。
手动改 locale.json 是最稳的兜底方案
如果命令面板搜不到 Configure Display Language,或选了 zh-cn 但重启后还是英文,说明 VS Code 没读到配置,直接编辑文件更可靠。
先彻底退出所有进程(Windows 查任务管理器是否有残留 Code.exe,macOS 看活动监视器里 Electron 是否还在),再定位并编辑:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容必须是标准 JSON:{"locale":"zh-cn"}(UTF-8 编码、无 BOM、无多余空格)。别写成对象嵌套或加注释——VS Code 会静默忽略整个文件。
部分区域仍是英文?这不是 bug,是设计如此
官方语言包覆盖率约 85%,菜单、设置页、提示框基本汉化,但以下情况英文属正常:
- 终端(Terminal)输出、Git 提交信息、npm/yarn 日志等,由底层工具决定,VS Code 不干预
- 某些插件(如
Prettier、ESLint)自带英文提示,需查其文档看是否支持独立语言配置 - 非官方主题(尤其自定义 UI 主题)可能覆盖本地化样式,临时切回
Default Dark+可验证 - 企业策略锁定了
VSCODE_LANG=en环境变量,或右下角 locale 显示灰色不可编辑,说明配置被强制覆盖,手动改文件也无效
最容易被忽略的细节:装包 ≠ 切语言,改配置 ≠ 生效,重启 ≠ 彻底退出。三者顺序不能错,且每一步都必须严格满足条件。


















