根本原因是VS Code的locale未切换,插件仅提供翻译资源;必须执行Configure Display Language命令选zh-cn并点Restart(非Reload Window),或手动创建严格格式的locale.json文件并彻底重启进程。

为什么装了中文插件菜单还是英文?
根本原因不是插件没装好,而是 VS Code 的界面语言(locale)没真正切换过去。插件只是“翻译词典”,不执行切换动作。只装 Chinese (Simplified) Language Pack 插件,但没运行 Configure Display Language 命令或没改 locale.json,就永远卡在英文界面。
常见错觉:右下角弹出“Restart”提示后点了“Reload Window”,这不够——必须点 Restart Now 或彻底关闭再打开,否则新 locale 不生效。
- Windows/macOS/Linux 路径下
locale.json必须是纯 JSON:{"locale":"zh-cn"}(注意双引号、小写、无多余空格或注释) - 如果用 Remote-SSH 连服务器开发,
locale.json要放在远程机器的对应路径里,本地装插件无效 - macOS 用户若系统语言设为英文且未勾选“自动切换语言”,VS Code 会优先读系统 locale,临时改成中文系统语言再试更可靠
Configure Display Language 命令选哪个值?
命令面板里输入 Configure Display Language 后弹出的列表中,**必须选 zh-cn 这个代码项**,不是“简体中文”文字,也不是 zh-CN(大小写敏感)、zh 或 Chinese (Simplified)。选错就等于没切。
这个命令本质是写入 locale.json,比手动编辑更安全,尤其适合刚装完插件但找不到配置文件位置的新手。
- 如果列表里压根没
zh-cn,说明插件没装成功或没启用,检查扩展面板里Chinese (Simplified) Language Pack状态是否为“已启用” - VS Code 1.80+ 版本才完全支持该命令稳定触发,旧版本建议直接改
locale.json - 执行后提示 Restart,务必确认——重载(Reload Window)≠重启(Restart),后者才是关键
菜单汉化不全怎么办?
官方语言包覆盖约 85% 的 UI,像右键菜单、调试控制台标题、部分扩展自己的 UI(如 GitLens 的弹窗)默认不翻译。这不是 bug,是设计限制。
想补全,得靠社区插件,但要注意兼容性:
-
Chinese Menu:专注右键菜单和上下文操作项,安装即生效,无需重启 -
vscode-zh-hans-menu:深度汉化设置页、调试面板、终端标题栏等冷门区域,但可能与新版 VS Code 冲突,装前查 GitHub 最近提交日期 - 终端/调试控制台仍为英文?这是正常行为——它们走的是底层 shell 或 debug adapter 的语言链路,和 VS Code 主 UI 分离;想统一,需在系统级设
LANG=zh_CN.UTF-8(Linux/macOS)或修改 Windows 区域格式
插件管理界面本身怎么汉化?
插件管理页(Ctrl+Shift+X)的“Search Extensions”、“Install”、“Disable”这些按钮,以及每个插件卡片里的“Install”、“Enable”、“Uninstall”文字,都属于 VS Code 主 UI 范畴,只要 locale 正确且插件启用,就会自动变成中文。
但如果看到插件名、描述仍是英文,别慌——那是插件作者自己写的 marketplace 元数据,VS Code 不翻译这部分。只有微软官方插件(如 C/C++、Python)才提供多语言描述,第三方插件基本只保留英文文案。
所以:菜单能汉化 ≠ 插件详情页能汉化,这是两个层级的事。
最易被忽略的一点:Remote 开发场景下,你看到的插件管理界面其实是远程端渲染的,locale.json 和语言包必须同时存在于远程机器上,本地装再多也白搭。


















