locale.json是唯一生效的语言配置文件，必须严格置于指定路径（Windows：%APPDATA%\Code\User\locale.json；macOS：$HOME/Library/Application Support/Code/User/locale.json；Linux：$HOME/.config/Code/User/locale.json），内容仅允许{"locale":"zh-cn"}（UTF-8无BOM、零空格、零多余字符）。
locale.json 是唯一生效的语言配置文件
VSCode 的界面语言不读 settings.json，也不认 "locale": "zh-cn" 这种写法——哪怕你把它塞进 settings.json 里，VS Code 完全忽略。真正起作用的只有单独存在的 locale.json 文件，且必须放在特定路径下，内容格式也极其严格。
各系统下 locale.json 的正确路径
路径错一个字符、多一层目录、或写到便携版 data 目录外，都会导致失效。三选一，按你的系统确认：
- Windows：
%APPDATA%\Code\User\locale.json（不是%USERPROFILE%\AppData\Roaming\Code\User\的别名写法，%APPDATA%是等效且更稳的环境变量） - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
注意：便携版 VS Code 要用 data/user-data/User/locale.json；Remote-SSH / WSL 则需在远程机器对应路径下单独配，本地的不透传。
locale.json 文件内容必须“零容错”
这个文件不是“可以写点别的 JSON”，而是只接受一行纯 JSON，且不能有任何额外字符：
- 必须是
{"locale":"zh-cn"}（双引号、小写、短横线、无空格、无逗号、无注释） - 不能是
{"locale": "zh-cn"}（冒号后有空格就失败） - 不能是
{"locale":"zh_CN"}或{"locale":"zh-hans"}（大小写、下划线、长横线均无效） - 编码必须是 UTF-8 无 BOM——用 VS Code 自己新建并保存最保险，别用记事本
- 文件存在但含其他字段（比如
{"locale":"zh-cn","foo":1}），整个文件被静默忽略
改完不生效？大概率卡在这三个环节
90% 的“设了没反应”，问题不在配置本身，而在执行过程：
- 没关干净进程：Windows 检查任务管理器是否有残留
Code.exe或Code Helper；macOS/Linux 用ps aux | grep code确认 - 右下角状态栏仍显示
en？说明 VS Code 启动时根本没读到locale.json，优先检查路径和文件名是否拼错 - 终端、调试控制台、Git 输出仍是英文？这正常——它们走各自进程的 locale，和 VS Code 主界面的
locale.json无关
真正要盯住的只有三处：设置页左侧导航栏文字、搜索框占位符、命令面板提示语。这些变了，才算汉化到位。
