vs code 的 locale.json 必须严格置于用户级指定路径：windows 为 %appdata%codeuserlocale.json，macos 为 ~/library/application support/code/user/locale.json，linux 为 ~/.config/code/user/locale.json；内容仅允许单行合法 json 如 {"locale":"zh-cn"}，编码为 utf-8 无 bom，修改前须彻底退出所有 vs code 进程，生效后界面菜单、设置页等主 ui 变中文即正确。
locale.json 文件路径必须精准对应系统类型
VS Code 只读取特定路径下的 locale.json，写错位置等于白改。它不认工作区级、远程连接级或旧版 .vscode/locales/ 路径——那些是过时文档或第三方误传的路径。
- Windows 正确路径：
%APPDATA%CodeUserlocale.json（即C:Users\AppDataRoamingCodeUserlocale.json） - macOS 正确路径：
~/Library/Application Support/Code/User/locale.json - Linux 正确路径：
~/.config/Code/User/locale.json
别用资源管理器直接搜 locale.json，容易找到缓存或临时文件；也别往 settings.json 里加 "locale": "zh-cn"，这个字段早已被忽略。
文件内容必须严格为单行合法 JSON
locale.json 不是配置模板，不是注释文件，也不是 settings.json 的子集。VS Code 启动时只解析它是否为有效 JSON 对象，且只取 locale 字段值。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 正确写法（仅且必须）：
{"locale":"zh-cn"} - 常见错误：多空格
{ "locale": "zh-cn" }、中文引号{“locale”:“zh-cn”}、逗号结尾{"locale":"zh-cn",}、写成zh_CN或zh-hans - 编码必须是 UTF-8 无 BOM；用 VS Code 自己打开编辑可能悄悄加 BOM，建议用记事本（Win）、TextEdit（macOS 设为纯文本）或
vim（Linux）保存
编辑前必须彻底退出 VS Code 进程
VS Code 后台常驻进程会锁住配置读取逻辑，哪怕窗口全关，locale.json 修改也可能被忽略。这不是缓存问题，是进程没释放配置句柄。
- Windows：打开任务管理器 → 结束所有
Code.exe进程（包括后台“隐藏图标”里的） - macOS：活动监视器 → 搜索
Electron→ 强制退出所有相关进程 - Linux：终端执行
pkill -f 'code'或killall code - 验证方式：重开 VS Code 后，右下角状态栏应显示
zh-cn（点击可切换），而非空白或英文代码
locale.json 生效后其他界面仍英文属正常现象
菜单栏、设置页、命令面板提示语变中文，就说明 locale.json 已生效。但终端、调试控制台、Git 输出、部分插件 UI 显示英文，不是配置失败——它们走各自独立的本地化路径，和 VS Code 主界面的 locale 无关。
真正容易被忽略的是：多人共用一台机器、或使用 WSL/SSH 远程开发时，locale.json 可能被写在错误用户目录下（比如 root 用户或远程服务器的 home 目录），导致本地启动无效。务必确认你编辑的是当前登录用户、且当前 VS Code 实例实际读取的那个路径。
