必须安装官方中文语言包并执行Configure Display Language命令设为zh-cn后重启,仅装插件或改settings.json无效;locale.json文件需由该命令自动生成且内容严格为{"locale":"zh-cn"},路径须在用户级目录,不可被工作区或远程配置覆盖。

VS Code 插件界面不会自动翻译成中文,必须手动安装语言包 + 显式设置 locale 才生效;只装插件、只改设置、或依赖系统语言,三者任缺其一都会卡在英文界面。
为什么装了 Chinese Language Pack 还是英文?
插件 Chinese (Simplified) Language Pack for Visual Studio Code 本质只是「翻译资源包」,不带激活逻辑。它提供的是 vscode-language-pack-zh-hans 这套字符串映射文件,但 VS Code 默认仍按系统语言或配置决定用哪套——就像下载了字幕文件,但播放器没打开字幕开关。
- 常见错误现象:
locale.json里写的是{"locale":"en"},哪怕插件已装,也强制走英文 - 容易被忽略的路径:便携版 VS Code 可能读取
Code\resources\app\locale.json而非用户目录下的配置 - 命令面板里搜不到
Configure Display Language?说明插件根本没装成功,或 ID 不对(认准ms-ceintl.vscode-language-pack-zh-hans)
Configure Display Language 命令失效怎么办?
该命令本质是写入或覆盖用户级 locale.json,若失败,大概率是权限或路径错位。此时应绕过 UI,直改配置文件。
- Windows:用记事本打开
%APPDATA%\Code\User\locale.json,内容设为{"locale":"zh-cn"} - macOS:编辑
~/Library/Application Support/Code/User/locale.json - Linux:编辑
~/.config/Code/User/locale.json - 改完必须完全退出 VS Code(任务管理器里确认
Code Helper进程已结束),再启动 - 如果工作区目录下存在
.vscode/locale.json,它会覆盖全局设置,删掉或同步改成zh-cn
终端、调试面板、右键菜单仍是英文?
这些模块属于 VS Code 的子进程或独立渲染层,不完全受主 locale 控制。官方汉化目前覆盖约 85%,剩余部分需补丁或妥协。
- 终端内执行
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans可刷新语言依赖缓存 - 右键菜单残留英文:可额外装社区插件
Chinese Menu(非官方,仅汉化上下文菜单) - 调试面板(Debug)术语如 “Breakpoint”、“Call Stack” 官方未翻译,属正常现象,不必强求
- 设置搜索框里输
locale,确认settings.json中无冲突项("locale"只应在locale.json里配,不在settings.json)
真正容易被忽略的是:绿色版、Snap 包、或通过浏览器访问的 vscode.dev,它们的语言机制和桌面版不同,locale.json 可能不可写或被沙箱拦截——这种情况下,换标准安装包是最省事的解法。


















