vscode汉化必须安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"、彻底重启三者缺一不可;搜“中文”易装错第三方包,须严格认准全名、发布者及id,手动改locale.json更稳。

搜“中文”插件大概率装错,必须认准全名和发布者
VS Code 官方唯一支持的简体中文语言包,名字是 Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文”“汉化”“chinese”等关键词,结果里混着大量第三方仿冒包——图标模糊、描述含糊、带广告或乱码,装了也不生效。
正确做法只有这一种:
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 在搜索框里严格粘贴全名:
Chinese (Simplified) Language Pack for Visual Studio Code - 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项,确认发布者是
Microsoft - 点击
Install,别信右下角弹出的 “Reload Window” 提示——它不切换语言
装完还是英文?关键一步:执行 Configure Display Language 命令
语言包只是“备好了翻译字典”,VS Code 默认仍用英文界面。必须手动告诉它“请用中文”,这步不能跳过,也不能靠设置界面里的旧选项。
操作路径很明确:
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在弹出的 JSON 文件中,把
"locale": "en"改成"locale": "zh-cn"(注意:小写、短横线、双引号包裹,zh_CN或zh-hans都无效) - 保存后,必须点弹窗里的
Restart按钮,或手动关掉所有窗口 + 杀掉后台进程再重开
命令面板打不开或没反应?直接改 locale.json 最稳
如果 Configure Display Language 命令搜不到、空白、报错,说明语言包没真正装好,或者 VS Code 没读到配置路径。这时候别折腾命令面板,直接编辑配置文件更可靠。
步骤要严格:
- 彻底关闭所有 VS Code 窗口,包括托盘/后台进程(Windows 查任务管理器中
Code.exe,macOS 查Electron) - 用 VS Code 自己打开对应路径下的
locale.json文件(通常位于~/.vscode/locales/locale.json或 Windows 的%USERPROFILE%\AppData\Roaming\Code\locales\locale.json) - 确保内容为:
{"locale":"zh-cn"},保存后重启
菜单汉化不全、终端仍是英文?这不是插件问题,是模块隔离设计
官方语言包对主界面汉化覆盖率约 85%,但终端(Terminal)、调试控制台(Debug Console)、部分扩展 UI 是独立渲染的组件,不会自动继承 locale 设置。
常见现象和应对:
- 右键菜单、设置项残留英文:可安装社区补丁插件如
Chinese Menu或vscode-zh-hans-menu,但要注意兼容性,新版 VS Code 可能冲突 - 终端内命令提示、Git 输出仍是英文:这是系统 shell 行为,VS Code 不干预;想统一,需在操作系统层面设系统区域语言(如 Windows 控制面板 → 区域 → 管理 → 更改系统区域设置)
- 调试控制台显示英文:目前无通用方案,依赖各调试器自身本地化支持(如 Node.js 调试器支持有限,Python 插件部分汉化)
真正容易被忽略的是:插件市场本身没有“中文版”,所谓“中文使用”只是靠语言包切换 UI,所有搜索、详情页、评分、评论都仍是英文内容——你看到的中文界面,只作用于编辑器内部,不影响 Marketplace 的原始数据源。











