vscode对locale.json格式极其敏感,非标准json会静默忽略并回退英文界面;唯一合法格式为{"locale":"zh-cn"},须严格满足:无空格、无注释、无尾逗号、双引号、小写连字符,且必须置于用户级正确路径下。

locale.json内容不是标准JSON会静默失效
VSCode 对 locale.json 的解析极其严格,任何非标准 JSON 都会被直接忽略,界面退回到英文——且不报错、不提示。这不是“没生效”,而是“压根没读进去”。
- 常见非法写法:
{"locale": "zh-cn" }(末尾空格)、{"locale":'zh-cn'}(单引号)、{"locale":"zh-cn",}(尾逗号)、{"locale":"zh-cn"//注释}(注释) - 合法且唯一被接受的格式只有一种:
{"locale":"zh-cn"}(无空格、无注释、双引号、小写、短横线) - 值必须是
zh-cn,不是zh_CN、zh-hans、Chinese或zh;大小写错误或连字符位置错,同样无效
手动创建locale.json时路径写错就白忙
locale.json 必须放在用户级配置目录下,其他任何位置(比如工作区 .vscode/、settings.json 同目录但拼错名、或放成 locale.js)全都不起作用。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- Windows 正确路径:
%APPDATA%\Code\User\locale.json - macOS 正确路径:
~/Library/Application Support/Code/User/locale.json - Linux 正确路径:
~/.config/Code/User/locale.json - 目录不存在?先执行
mkdir -p ~/.config/Code/User(Linux/macOS)或在资源管理器中逐级新建(Windows)
文件编码或权限问题导致写入失败
即使内容和路径都对,UTF-8 with BOM、文件被锁定、或当前用户无写权限,也会让 VSCode 读取失败并回退英文。
- 用 VSCode 自身打开该路径下的
locale.json,保存前确认右下角显示「UTF-8」且无「BOM」字样;若显示「UTF-8 with BOM」,点击它 → 选「Save with Encoding」→ 「UTF-8」 - Windows 上若曾用「管理员身份运行」VSCode,可能导致
%APPDATA%\Code\User\目录归属异常:右键该文件夹 → 属性 → 安全 → 编辑 → 确保当前用户有「完全控制」 - macOS/Linux 下检查权限:
ls -l ~/.config/Code/User/locale.json,若属主不是你,运行sudo chown $(whoami) ~/.config/Code/User/locale.json
改完locale.json后仍显示英文?检查覆盖源
locale.json 是用户级设置,但会被更高优先级的配置盖掉——此时文件本身没问题,只是没机会生效。
- 检查当前打开的项目根目录下是否有
.vscode/settings.json,里面是否含"locale": "en"或"locale": "zh-cn";有则删掉或注释掉整行 - 检查启动方式:快捷方式「目标」字段、终端 alias(如
alias code='code --locale=en')、或脚本里是否带--locale=en参数 - Remote-SSH / Dev Container 场景下,本地改了没用:需登录远程机器,同样处理其
~/.config/Code/User/locale.json
locale.json,确认内容是那一行纯 JSON,再杀掉所有 Code 进程重启——这是最接近真相的操作。










