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 会直接忽略整个文件，回退英文。

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

改完必须彻底重启进程，不是“重载窗口”

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 到错误日志，只默默跳过。