locale.json必须是严格合法的json,路径、编码、大小写三者缺一不可;正确格式仅{"locale":"zh-cn"},单引号、bom、空格、注释或大小写错误均导致静默失效。

locale.json 文件内容必须是合法 JSON
VS Code 只读取严格符合 JSON 规范的 locale.json,哪怕多一个空格、少一个引号、用了中文标点或带 BOM,它都会静默忽略该文件,回退英文界面。这不是报错,而是直接跳过——所以你改了却没效果,大概率是语法“看起来像 JSON”,但实际非法。
检查 locale.json 是否存在且路径正确
先确认文件在对的位置,否则根本不会被加载:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
用文件管理器或终端直接打开对应路径,看 locale.json 是否真实存在。如果不存在,说明 Configure Display Language 命令从未成功执行;如果存在但为空或只有花括号,说明写入失败或被清空过。
验证 JSON 格式是否合法
打开 locale.json,内容**必须且只能是这一行**:
{"locale":"zh-cn"}
常见非法写法包括:
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 用单引号:
{'locale': 'zh-cn'}❌ - 大小写错误:
{"locale": "ZH-CN"}或{"locale": "zh_CN"}❌ - 多字段或注释:
{"locale":"zh-cn","fallback":"en"}或// 中文❌ - 带 UTF-8 BOM(尤其 Windows 记事本默认保存格式)❌
- 换行或多余空格:
{"locale": "zh-cn" }(末尾空格)❌
最稳妥做法:用 VS Code 自身打开该文件,全选 → 删除 → 手动输入 {"locale":"zh-cn"}(不加空格、不换行),保存后关闭所有 VS Code 进程再重启。
用命令行快速验证 JSON 合法性
终端中执行以下命令可快速检测(适用于 macOS/Linux;Windows 可用 PowerShell):
cat ~/.config/Code/User/locale.json | jq .
若输出原始内容,说明合法;若报错如 parse error: Invalid string: control characters from U+0000 through U+001F must be escaped,就是 BOM 或不可见字符问题。此时建议用 VS Code 重写,不要用记事本或 TextEdit。
真正容易被忽略的是:文件路径、编码、大小写三者必须同时满足,缺一不可。哪怕只错一个字母,VS Code 就当它不存在。










