必须安装microsoft官方中文语言包、执行configure display language命令设locale为"zh-cn"、并彻底重启vs code进程,三者缺一不可;settings.json中配置无效,仅用户级locale.json生效。

VSCode界面全是英文,不是没汉化,而是语言包没装对、locale没设准、或进程没彻底重启——三者缺一不可。
为什么装了中文插件还是英文?
只安装 Chinese (Simplified) Language Pack for Visual Studio Code(发布者必须是 Microsoft)还不够。这个插件只是“翻译资源库”,VS Code 启动时根本不会自动调用它。必须通过 Configure Display Language 命令显式指定使用哪套资源,否则界面、设置页(Ctrl + ,)、错误提示、命令面板全保持英文。
- 搜 “chinese” 安装非官方包(如
Chinese Language Pack或VSCode Chinese)→ 翻译不全、部分字段乱码、甚至覆盖 locale 配置 - 在扩展市场点错“语言包”和“主题/语法高亮”类插件 → 完全无效
- 装完没执行
Configure Display Language→ 插件闲置,等于没装
settings.json 里写 "locale": "zh-cn" 为什么没用?
VS Code 1.70+ 版本已彻底弃用 settings.json 中的 locale 字段。你加了它,VS Code 启动时既不报错也不读取,静默忽略。
- 真正生效的配置文件是独立的
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"}(注意:双引号、小写、短横线,不能是zh_CN、zh-hans或zh-cn漏引号) - 手动编辑易出错;推荐永远用
Configure Display Language命令生成,它能自动校验路径、格式、权限
点了 Reload Window 还是英文?关键在“彻底退出”
VS Code 的语言环境绑定到进程实例。如果旧窗口没完全关闭,后台残留 Code.exe(Windows)或 Electron(macOS)进程,新窗口会继承旧语言状态,导致 reload 失效。
- 右下角状态栏显示
en→ 说明语言没切成功 - 不要只关窗口,要右键任务栏图标选“退出”,或 macOS 上从 Dock 右键选“退出”
- Windows 用户建议打开任务管理器,结束所有
Code.exe进程;macOS 用户可用活动监视器查Electron - 改完 locale 后,必须等弹窗提示“需要重启窗口”,然后点
Restart(不是Reload Window,后者不重载语言环境)
最常被忽略的其实是 locale.json 的位置和格式:它不在项目目录、不在系统级路径、也不能混在 settings.json 里;一个空格、一个大小写、一个错位的引号,都足以让整个汉化失效。











