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

装对语言包是第一步,别搜“中文”就点安装
VSCode 本身不带中文界面,必须靠 Microsoft 官方语言包加载翻译资源。搜索时输 chinese 会出来一堆非官方插件,比如名字带“汉化”“增强”“一键”的,这些不是语言包,点了就踩坑。
只认这一个:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 MS-CEINTL.vscode-language-pack-zh-hans。在扩展面板(Ctrl+Shift+X)里粘贴全名搜最稳。
- 装错插件会导致命令面板搜不到
Configure Display Language - 扩展图标变灰 = 被禁用,得手动启用
- 装完没反应?大概率只是“字典备好了”,还没告诉 VSCode 去用它
执行 Configure Display Language 才真正切换语言
语言包只是资源,切换动作靠内置命令 Configure Display Language。它会写入 locale.json,不是改 settings.json。
操作路径:Ctrl+Shift+P → 输入 Configure Display Language → 回车 → 选 zh-cn(注意:必须是小写、带短横线,不能是 zh_CN、zh 或文字“简体中文”)→ 弹窗出来后,**必须点 Change and Restart**。
- 点
OK或关掉弹窗 = 白忙活 - 点
Developer: Reload Window= 不重载语言环境,无效 - VSCode ≥ 1.70 版本(2023 年 11 月后基本都满足)走这步就能生效
手动建 locale.json 是最稳的兜底方案
命令面板打不开、远程开发、公司策略禁装插件,或者试了上面两步还是英文——直接写配置文件最可靠。
文件路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
内容只写一行,严格按格式:
{"locale":"zh-cn"}
- 文件不存在?直接新建,VSCode 启动时自动识别
- 编码必须是 UTF-8 无 BOM,否则整行被忽略
- 别写成
"zh_CN"、"zh"或带空格/注释 - 远程开发(如 Remote-SSH / WSL)需在远程端也配同路径的
locale.json
终端和调试控制台仍是英文?这不是 Bug
菜单、设置页变成中文 ≠ 集成终端(Ctrl+`)或调试控制台也变。这是设计如此,它们不继承主窗口的 locale 设置。
它们的语言由系统环境变量(如 LANG)、启动参数(--locale=zh-cn)或终端自身 locale 决定,和 VSCode 界面汉化无关。
如果连菜单都是英文,先别管终端;等主界面切成功了,再单独处理终端语言——那是另一个问题域。











