vscode 界面语言只能通过用户数据目录下 user/locale.json 文件设置,内容为 {"locale":"en"} 或 {"locale":"zh-cn"},需彻底关闭进程后重启生效,其他方式均无效。

VSCode 界面语言只能靠 locale.json 控制,其他任何方式(包括 settings.json 里写 "locale")都无效。 它不是“可选配置”,而是唯一生效路径——改错位置、格式或没关干净进程,就一定不生效。
为什么必须手动编辑 locale.json
VSCode 1.80+ 版本已移除命令面板中的 Configure Display Language 命令;即使旧版本能调出该命令,也常因插件未安装、路径写错或后台进程残留而静默失败。直接操作 locale.json 绕过所有中间层,是当前最可靠手段。
-
locale.json必须放在用户数据目录下的User/子目录中,不是项目根目录的.vscode/,也不是系统级配置路径 - 文件名必须是
locale.json(大小写敏感),不能是locale.txt或Locale.json - 内容必须为严格合法 JSON:只有一行,无注释、无多余空格、无 BOM —— 推荐用 VS Code 自己新建并保存,天然规避编码问题
locale.json 的正确路径和内容
先彻底关闭 VSCode(Windows 查任务管理器杀光所有 Code.exe,macOS 查活动监视器里的 Electron 进程),再按系统打开对应路径:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容只写这一行(英文界面):
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
{"locale":"en"}
或这一行(中文界面):
{"locale":"zh-cn"}
注意:zh_CN、zh-hans、Chinese、zh 全都不认;大小写、连字符、引号缺一不可。
常见失效原因和验证点
改完仍不生效?优先检查这三处硬性条件是否全部满足:
-
locale.json是否真的在用户级User/目录下(不是工作区.vscode/) - 文件是否被其他程序占用(如用记事本编辑后未关闭,VS Code 启动时读取失败)
- VS Code 是否真正重启:点击「Restart Now」或完全退出再打开,
Reload Window不重读locale.json
验证是否成功,只看三处:顶部菜单栏文字、左侧活动栏 hover 提示、设置里搜 Display Language 显示的值——这三处一致了,就是真生效。终端、调试控制台、Git 输出仍是英文,属于正常现象,它们不走 VS Code 主 locale 流程。










