直接运行 configure display language 命令并选择 zh-cn 即可恢复中文界面,该命令自动创建正确路径和格式的 locale.json 文件,无需手动编辑配置或重装。

输入 Configure Display Language 命令就能切回中文
VSCode 界面突然变英文,90% 是因为语言设置被意外覆盖或 locale.json 损坏,但不用改配置文件、也不用重装——直接调用内置命令最稳。无论当前是英文、日文还是乱码界面,Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)都能唤出命令面板,这是唯一跨语言、跨版本一致有效的入口。
输入 Configure Display Language 后回车,会弹出语言列表。关键点在于:必须选 zh-cn,不是 zh_CN、zh-CN,也不是 “Chinese (Simplified)” 文字项——只有这个小写带连字符的代码才被识别为有效 locale。
- 如果列表里没有
zh-cn,说明中文语言包没装,命令会自动跳转到扩展页,点 Install 即可 - 安装完别手动关窗口,等右下角弹出提示后点
Reload Window(不是 Ctrl+R 刷新,也不是完全退出再开) - 若点了 Reload 仍无效,大概率是
locale.json被写到了工作区目录(.vscode/locale.json),而 VSCode 1.70+ 只认用户级路径下的文件
locale.json 才是真正起作用的配置文件,settings.json 里的 "locale" 已失效
VSCode 从 1.70 版本起已彻底弃用 settings.json 中的 "locale": "zh-cn" 配置项。你加了它,VSCode 启动时既不报错也不读取,纯属静默忽略。真正生效的是独立的 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"}。多一个空格、少一个引号、写成 locale.language 都会导致失败。建议永远用 Configure Display Language 命令生成它,而非手写——命令能确保路径、格式、权限全对。
中文语言包必须装官方版:Chinese (Simplified) Language Pack for Visual Studio Code
扩展市场搜 chinese 会出现一堆非官方包,比如 Chinese Language Pack 或 VSCode Chinese,这些无法被 Configure Display Language 识别,装了也白装。必须认准完整名称和作者:
- 名称:
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者:
Microsoft - 安装命令(终端中执行):
ext install vscode-language-pack-zh-hans
装完不等于生效。插件只是“备好翻译资源”,Configure Display Language 才是“激活开关”的动作。漏掉这一步,界面永远是英文。
Reload Window 失败的三个隐藏原因
点了右下角的 Reload Window 却还是英文?不是命令错了,而是环境干扰了 locale.json 的读取位置或内容:
-
locale.json被写进了当前项目目录(.vscode/locale.json),但 VSCode 只在用户级路径下查找它 - 系统里存在多个 VSCode 实例(比如通过终端启动的、桌面快捷方式启动的),它们可能读取不同配置路径
- 杀毒软件或磁盘同步工具(如 OneDrive、iCloud)锁住了
locale.json,导致 VSCode 读到旧缓存或空文件
最干净的排查方式:完全退出所有 VSCode 进程,删掉用户级 locale.json,再重新走一遍 Configure Display Language 流程——命令会重建正确路径下的文件,绕过所有手写错误和路径混乱。











