安装中文语言包后菜单仍英文,需确认 locale 设置为 zh-cn 并完全重启;右键菜单等由系统或 electron 提供,无法汉化;settings.json 中的 locale 会覆盖其他设置,须删除或修正。

安装中文语言包后部分菜单仍是英文?先确认 locale 设置是否生效
VSCode 的界面语言不依赖插件自动激活,而是由 locale 配置项驱动。即使已安装 ms-ceintl.vscode-language-pack-zh-hans,只要 locale 未设为 zh-cn,菜单、设置页、命令面板等核心 UI 就仍显示英文。
常见错误现象:安装插件后重启,「文件」「编辑」「调试」等顶部菜单仍是英文;设置里搜索 locale 显示值为 en 或为空。
- 打开命令面板(
Ctrl+Shift+P或Cmd+Shift+P),输入并执行Configure Display Language - 在弹出列表中**必须选
zh-cn(小写、连字符,不是zh_CN或zh-CN)** - 点击「Restart」——注意是**完全重启 VS Code 进程**,不是「Reload Window」
- 重启后检查设置页搜索
locale,确认右侧下拉菜单显示为zh-cn
右键菜单、终端标签、资源管理器路径等仍为英文?这不是 bug,是 Electron 层限制
VSCode 基于 Electron,部分 UI 元素(如右键上下文菜单里的 Copy Path、Reveal in Explorer,终端标签页的 Terminal 文字,甚至状态栏的 Ln X, Col Y)由 Chromium 或操作系统底层提供,**不受 VSCode 语言包控制**。
这类内容无法通过 locale.json 或插件汉化,属于设计限制,不是配置错误或插件失效。
-
Copy Path、Open in Integrated Terminal等右键项 → 操作系统级字符串,Windows/macOS/Linux 各自决定显示语言 - 终端标题栏文字(如
Terminal 1)→ Electron 自带本地化,仅支持有限语言,简体中文未覆盖全部术语 - 编辑器底部状态栏的
Ln 12, Col 5→ VSCode 本身未对这部分做完整本地化,目前仍保持英文缩写
settings.json 中误写 "locale": "en" 会覆盖所有语言设置
如果手动编辑过 settings.json,且其中存在显式声明 "locale": "en" 或类似字段,它会**优先于命令面板和 locale.json 的设置**,导致中文包完全失效。
这是最容易被忽略的冲突点,尤其在多人协作或从旧配置迁移时。
- 打开设置(
Ctrl+,),点击右上角「打开设置 (JSON)」图标 - 搜索
locale,删除整行"locale": "en"或改为"locale": "zh-cn" - 不要同时在
settings.json和locale.json中设置locale,二者冲突时以settings.json为准 - 改完保存,**必须完全退出 VS Code(包括后台进程)再重开**,否则缓存可能使修改不生效
企业内网或离线环境安装失败?绕过 Marketplace 直接装 .vsix
国内部分网络环境无法访问 VS Code 扩展市场,搜索不到官方中文包,或下载卡在 0%,此时用 Marketplace 页面下载 .vsix 文件是最稳方案。
别信第三方「汉化补丁」或非微软签名的「Chinese UI」插件,它们常篡改 product.json 或注入脚本,升级后易崩溃。
- 访问
https://marketplace.visualstudio.com/items?itemName=ms-ceintl.vscode-language-pack-zh-hans - 点击「Download Extension」获取
vscode-language-pack-zh-hans.vsix - 在 VS Code 中按
Ctrl+Shift+P,运行Extensions: Install from VSIX... - 选择下载的
.vsix文件,安装后仍需执行Configure Display Language→zh-cn→ 重启
locale 的最终取值,而这个值可能来自四个地方:命令面板、locale.json、settings.json、启动参数(如 code --locale=zh-cn)。优先级从高到低,稍有错位就白装。最保险的做法是删掉所有冗余配置,只留 locale.json 一行 {"locale":"zh-cn"},然后彻底杀掉 VS Code 进程再启动。











