vscode中文界面需严格配置locale.json文件：windows路径为%appdata%\code\user\locale.json，macos为$home/library/application support/code/user/locale.json，linux为$home/.config/code/user/locale.json；内容仅允许单行合法json{"locale":"zh-cn"}，且必须彻底退出进程后重启生效。
locale.json 文件路径必须完全匹配系统类型
VS Code 只在固定路径下读取 locale.json，写错一个字符（比如多一个空格、少一个斜杠）或选错系统路径，它就直接忽略整个文件，静默回退英文。不是报错，是“假装没看见”。
确认你正在编辑的文件路径准确无误：
- Windows：
%APPDATA%\Code\User\locale.json（注意不是%USERPROFILE%\AppData\Roaming\Code\User\locale.json的长路径形式，%APPDATA%是等效且更稳的写法） - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
用 VS Code 自己打开该路径——比如在终端执行 code %APPDATA%\Code\User\locale.json（Windows）或 code $HOME/Library/Application\ Support/Code/User/locale.json（macOS），避免用记事本、TextEdit 等可能加 BOM 的编辑器。
locale.json 内容必须是严格合法的单行 JSON
VS Code 对 locale.json 的解析极其苛刻：只接受一行、无 BOM、双引号、小写、连字符、无多余空格或逗号。任何偏差都会导致整个文件被跳过。
正确内容只有一行，且仅此一行：
{"locale":"zh-cn"}
常见错误包括：
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 写成
{"locale": "zh-cn"}（值前后有空格） - 写成
{"locale":"zh_CN"}或{"locale":"zh-hans"}（非标准 BCP 47 标签） - 保存为 UTF-8 with BOM（Windows 记事本默认行为）
- 文件末尾多了换行或逗号，如
{"locale":"zh-cn"}, - 用了全角引号（“”）或中文冒号（：）
重启必须彻底杀掉所有后台进程
改完 locale.json 后点「重新加载窗口」完全无效。VS Code 的语言上下文在主进程启动时一次性读取，不监听文件变更。
必须确保没有残留进程：
- Windows：打开任务管理器 → 结束所有名为
Code.exe的进程（包括后台服务进程） - macOS：活动监视器 → 搜索
Electron和Code Helper→ 全部强制退出 - Linux：
pkill -f "code.*--no-sandbox"或手动查ps aux | grep code后kill
再全新启动 VS Code（不是从 Dock 或开始菜单“恢复”，而是双击图标或运行 code 命令）。启动后立刻看右下角状态栏，显示 zh-cn 才算真正加载成功。
验证中文是否真生效，只盯三处核心区域
别去检查终端、Git 输出、调试控制台或某个插件的设置页——它们压根不读 locale.json，显示英文是设计如此，不是配置失败。
真正反映 locale.json 是否起作用的只有这三处：
- 顶部菜单栏文字（「文件」「编辑」「视图」等）
- 命令面板提示语（按
Ctrl+Shift+P后顶部显示「请输入命令或搜索设置」） - 设置界面左侧导航栏（「用户」「工作区」「扩展」）
这三处全中文，说明 locale.json 配置已成功接管主 UI；其余地方仍是英文，属于正常行为。
