VSCode界面变中文需三步:安装Microsoft官方简体中文语言包(ID为ms-ceintl.vscode-language-pack-zh-hans)、执行Configure Display Language命令选zh-cn、彻底退出所有进程后重启;缺一不可,装错第三方插件或写错locale值均无效。

VSCode 默认不显示中文菜单,必须安装官方语言包并显式切换显示语言才能生效。只改设置或装错插件,界面大概率还是英文。
怎么确认是否已装对官方中文语言包
打开扩展面板(Ctrl+Shift+X),在搜索框输入 chinese(小写),认准名称为 Chinese (Simplified) Language Pack for Visual Studio Code、发布者是 Microsoft、带蓝色官方认证标识的那一个。其他名字类似但发布者不是 Microsoft 的,比如 “Chinese Menu” 或 “vscode-zh-hans-menu”,属于第三方补丁,不推荐作为主方案——它们可能汉化不全、升级后失效,甚至干扰调试器提示。
如果已安装但没反应,检查是否被禁用:右键该扩展 → 点击“启用”。再确认 VSCode 版本是否 ≥ 1.80(2023 年后的新版强制要求),旧版本即使装了也加载不了。
切换显示语言的两种可靠方式
方式一(推荐):用命令面板快速切换。Ctrl+Shift+P 打开命令面板,输入 Configure Display Language,回车后选择 zh-cn,点击 Restart 按钮重启。这个操作会自动修改 locale.json 文件,比手动编辑更安全。
方式二(备用):手动编辑配置文件。关闭 VSCode,在用户数据目录下找到 locale.json(Windows 路径通常是 %USERPROFILE%\AppData\Roaming\Code\User\locale.json,macOS 是 ~/Library/Application Support/Code/User/locale.json),确保内容为:
{"locale":"zh-cn"}
保存后重启。注意:不要手误写成 "zh_CN" 或 "zh",大小写和短横线必须严格匹配 zh-cn。
菜单还是部分英文?这是正常现象,别硬刚
官方语言包目前汉化覆盖率约 85%,以下几类内容默认仍是英文,不是你配错了:
-
Debug面板里的变量类型(如string、number)、断点状态(Hit Count)等底层调试信息,VSCode 不翻译,也不建议翻译——这些是标准术语,混着看反而利于查文档 - 终端(Terminal)输出、代码运行日志、Git 提示,全部由系统或对应工具链生成,VSCode 无法也不应该干预
- 部分插件(如
Python、C/C++)自己的设置项、右键菜单,需单独安装其配套语言包,例如Python Extension Pack自带简体中文支持,但得手动开启
如果你发现连“文件”“编辑”“视图”这种一级菜单还是英文,那基本是语言包没装成功或没重启,不是覆盖率问题。
乱码、字体发虚、中文显示不全怎么办
界面变中文后出现方块、文字重叠、字号过小,本质是字体 fallback 链没配好。打开设置(Ctrl+, ),搜索 editor.fontFamily,把值设为:
'Fira Code', 'Microsoft YaHei', 'PingFang SC', 'sans-serif'
其中 Microsoft YaHei(微软雅黑)是 Windows 下最稳的中文字体;macOS 推荐 PingFang SC;Linux 用户可换为 Noto Sans CJK SC。别只写一个中文字体,一定要前置等宽英文字体(如 Fira Code),否则代码里的符号和数字会糊成一团。
如果改完仍乱码,检查系统是否缺失中文字体支持(尤其是 WSL 或 Docker 容器内运行 VSCode 的场景),此时需要在宿主机安装对应字体,而非在 VSCode 里折腾。


















