必须安装Microsoft官方中文语言包并执行Configure Display Language命令设zh-cn后彻底重启,三者缺一不可;装错第三方插件、漏重启或locale值错误(如zh_CN)均导致无效。

安装 Chinese (Simplified) Language Pack 扩展
VSCode 本身不带中文界面,必须通过官方扩展加载语言资源。这个包叫 Chinese (Simplified) Language Pack for Visual Studio Code,由 Microsoft 官方维护,不是第三方汉化补丁。
安装方式有两种:一是按 Ctrl+Shift+X(Windows/Linux)或 Cmd+Shift+X(Mac)打开扩展面板,搜 chinese,认准带蓝勾认证、发布者是 Microsoft 的那个;二是直接在扩展市场页面 URL 中粘贴:https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans。
常见错误现象:
- 搜到一堆“中文增强”“一键汉化”插件,点进去发现作者不明、更新停滞、评分低——这些不是语言包,别装
- 安装完没反应,菜单还是英文——大概率漏了下一步的「切换语言」操作
- 扩展图标变灰(被禁用),需手动启用
执行 Configure Display Language 命令
装完扩展只是“准备好翻译材料”,真正让 VSCode 切换语言,得靠 Configure Display Language 这个命令。它会修改 locale.json 文件里的 "locale" 字段值。
操作路径:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(Mac)打开命令面板 - 输入
Configure Display Language,回车 - 在弹出列表中选
zh-cn(不是“简体中文”文字项,而是带引号的代码值) - 看到右下角提示框时,务必点击
Change and Restart——只点OK或关掉弹窗都不生效
如果你的 VSCode 版本 ≥ 1.70(2023 年 11 月后发布的版本基本都满足),这一步就能完成全部切换。低于 1.40 的旧版不支持该机制,需手动建 locale.json。
手动修改 locale.json 文件(备用方案)
当命令面板打不开、扩展商店抽风、或公司策略禁用了插件安装时,直接写配置文件是最稳的兜底方式。
文件路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
内容只需一行 JSON:
{"locale":"zh-cn"}
注意事项:
- 如果文件不存在,直接新建一个,VSCode 启动时会自动识别
- 改之前建议备份原文件,避免误操作导致启动失败
- 不要写成
"zh_CN"或"zh",必须是小写连字符格式"zh-cn" - 改完保存,关闭所有 VSCode 窗口再重新打开,不要只刷新窗口(
Developer: Reload Window不触发语言重载)
为什么部分菜单/插件仍是英文?
VSCode 主界面变成中文,并不等于所有东西都汉化了。这是正常现象,原因有三:
- 插件自身未提供中文语言包:比如 Python、C/C++ 扩展的右键菜单、设置项、提示文案,需要各自单独汉化,和 VSCode 本体无关
- 终端(Integrated Terminal)输出内容不受界面语言影响:你运行
node --version或git status,结果仍是英文,这是 shell 和 CLI 工具决定的,不是 VSCode 能控制的 - 某些底层 UI 组件(如调试器变量视图、任务输出面板标题)仍保留英文关键词:微软刻意为之,避免翻译歧义影响排查,比如
Call Stack翻成“调用堆栈”反而让新手更难对应概念
最容易被忽略的一点:远程开发(SSH / WSL / Containers)场景下,语言包只装在本地 VSCode,远端环境里没有,所以远端终端、远端插件界面依然英文。这时得在远端也装一次语言包,或统一用 en 避免错位。











