locale.json 是 vs code 唯一认的界面语言配置文件,必须严格写成 {"locale":"zh-cn"},保存为 utf-8 无 bom 编码,置于指定路径,且需彻底重启进程才生效。

locale.json 是 VS Code 唯一认的界面语言配置文件,必须严格写成 {"locale":"zh-cn"},多一个空格、少一个引号、用错编码都会静默失效。
locale.json 文件路径必须准确
VS Code 不会自动创建这个文件,也不会从 settings.json 或其他位置读取 locale 配置。它只在固定路径下查找并加载:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
注意:%APPDATA% 在 Windows 上通常展开为 C:\Users\用户名\AppData\Roaming;路径中不能含中文字符或空格,否则 VS Code 可能跳过读取。
内容格式和编码有硬性要求
这个文件不是 JSON5,也不是 settings.json 的子集,它只接受一行标准 JSON,且必须满足三项条件:
- 只有一行,无换行、无注释、无多余逗号或空格
- 键名必须是
locale(小写),值必须是"zh-cn"(全小写、短横线、双引号) - 保存为 UTF-8 无 BOM 编码 —— 用 VS Code 自己打开并保存即可保证;用记事本保存极易带 BOM
错误示例:{"locale": "zh_CN"}、{"locale":"zh-hans"}、{"locale": "Chinese"}、{"locale":"zh-cn",} —— 全部无效,VS Code 会直接忽略整个文件,回退英文。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
改完必须彻底重启进程,不是“重载窗口”
VS Code 只在启动时读一次 locale.json。以下操作都不生效:
- 点 Developer: Reload Window
- 关掉当前窗口再新建一个
- 在命令面板里执行 Configure Display Language 后又点了 Cancel
正确做法是:
- 关闭所有 VS Code 窗口
- 检查后台进程:Windows 看任务管理器是否有残留
Code.exe;macOS 看活动监视器里的Electron或Code Helper - 确认无残留后,全新启动 VS Code
启动后右下角状态栏会显示当前语言代码(如 zh-cn),点击它可快速验证是否已加载成功。
真正容易被忽略的是:哪怕你装了 Microsoft 官方语言包、也写了 locale.json,只要路径错、编码错、JSON 格式错、或进程没杀干净,VS Code 就不会报错,只会安静地继续英文界面——它不提示、不警告、不 fallback 到错误日志,只默默跳过。










