vs code插件界面不会自动汉化,必须安装microsoft官方语言包、显式设置locale为"zh-cn"并彻底重启进程,三者缺一不可;插件菜单/设置页仍英文是因为多数插件ui依赖vs code主体语言,且第三方插件易引发乱码或失效。

VS Code 插件界面不会自动汉化,必须安装 Microsoft 官方语言包 + 显式设置 locale 为 zh-cn + 彻底重启进程,三者缺一不可。
为什么插件菜单/设置页还是英文?
多数插件(如 GitLens、Prettier、ESLint)自身不带翻译,它们的 UI 文字由 VS Code 主体语言决定。但有例外:
- 部分插件(如
GitLens)提供独立语言配置项,例如gitlens.language,需手动设为"zh-cn" - 某些插件 WebView 页面(如 Copilot Chat、CodeBuddy)依赖远程服务,语言由服务端返回,本地
locale不影响其显示 - 主题类插件(尤其非官方暗黑主题)可能硬编码英文文案,或覆盖字体渲染导致中文显示异常
只装“中文插件”就生效?错,必须认准官方扩展
搜 “中文”“汉化” 极大概率装错——第三方插件常引发乱码、菜单重叠、甚至劫持设置入口。唯一有效的是:
- 在扩展面板(
Ctrl+Shift+X)搜索:Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 安装后别点右上角 Reload——它不触发语言环境重载
- VS Code
1.13+版本才内置该机制,旧版本需先升级
locale.json 文件位置和格式必须严格正确
settings.json 里写 "locale": "zh-cn" 已失效(VS Code 1.70+ 彻底弃用)。真正起作用的是独立的 locale.json,且只读用户级路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容必须是合法 JSON,仅一行,无空格、无 BOM、全英文符号:
{"locale":"zh-cn"}
写成 zh_CN、zh-hans、Chinese 或漏掉引号,VS Code 都会静默回退到英文。
重启不是点 Reload Window,而是杀干净进程再开
VS Code 的语言环境绑定在进程实例上。后台残留进程会导致新窗口复用旧状态:
- Windows:任务管理器中结束所有
Code.exe进程(包括后台服务) - macOS:活动监视器中查
Electron,或终端执行pkill -f "Electron.*Code" - Linux:运行
pkill -f "code.*--no-sandbox" - 右下角状态栏仍显示
en?说明没彻底退出
验证是否生效,唯一可靠方式是打开命令面板(Ctrl+Shift+P),看提示文字是否变成“请输入命令或搜索设置”。
最常被忽略的不是步骤顺序,而是 locale.json 的路径层级和文件编码——它必须放在 User 目录下,且不能是 UTF-8 with BOM;一旦放错位置或格式出错,VS Code 就当它不存在。











