必须安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"、并彻底重启vs code进程,三者缺一不可;装错第三方插件或未彻底重启是界面部分中文部分英文的最常见原因。

安装 Chinese (Simplified) Language Pack 插件必须认准 Microsoft 官方版本
装错插件是界面部分中文、部分英文的最常见原因。VS Code 本身不带中文资源,所谓“汉化”全靠这个插件提供翻译文件,但它只负责打包,不自动启用。
- 打开扩展面板:
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS) - 搜索完整名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 严格核对发布者是
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 别点
Chinese Language Pack、VSCode Chinese或任何非 Microsoft 签名的插件——它们会导致命令面板乱码、设置项不翻译
安装后右下角可能弹出提示,但此时菜单栏、设置页仍是英文,这是正常现象:插件只是“备好了字典”,还没告诉 VS Code “请翻这本书”。
Configure Display Language 命令必须手动执行且选 zh-cn
很多人装完就重启,发现没变化,卡在这一步:命令名里没有“中文”“汉化”字样,纯靠拼音缩写,容易输错或漏选。
- 按
Ctrl+Shift+P打开命令面板(不是Ctrl+P) - 输入并选择:
Configure Display Language - 在弹出列表中明确选
zh-cn(小写、连字符,不是zh_CN、zh-hans、Chinese或zh) - 出现「是否重启窗口」提示时,一定点「是」——
Reload Window不会重读语言配置,无效
这一步本质是修改 locale.json 文件,而非 settings.json。如果命令搜不到或执行空白,大概率是插件没装成功,或 VS Code 没读到配置路径。
locale.json 路径和内容必须准确,重启要彻底
命令面板失效、或切换后仍英文时,直接编辑配置文件最稳。但 90% 的“改了没反应”,都源于改错文件或没关干净进程。
-
locale.json路径(不是settings.json):
Windows:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
macOS/Linux:~/.vscode/locale.json - 文件内容只有一行合法 JSON:
"locale": "zh-cn" - 保存后必须关闭所有 VS Code 窗口,并确认后台进程已退出:
Windows 查任务管理器中是否还有Code.exe
macOS 用活动监视器查Electron进程 - 再全新启动,右下角状态栏会显示当前语言代码(如
zh-cn),点击它也能快速切换
改 settings.json 加 "locale": "zh-cn" 完全无效——这个字段在那里不被识别。
验证时只看三处核心区域,其他英文属正常
终端、调试控制台、Git 面板、某些插件弹窗天生不走 locale 配置,显示英文 ≠ 汉化失败。别被这些区域误导,反复折腾。
- 顶部菜单栏:
文件、编辑、视图、终端是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示「请输入命令或搜索设置」 - 设置界面:
Ctrl+,打开后,左侧导航栏用户、工作区、扩展及搜索占位符是否为中文
右键菜单、部分插件 WebView 页面、Remote-SSH/WSL 环境中的语言设置需单独处理;企业策略也可能锁定 locale 字段,导致其在设置中呈灰色不可编辑。











