locale.json 是 VS Code 唯一生效的语言配置文件，必须严格置于用户级数据目录对应路径、命名为 locale.json、保存为无 BOM 的 UTF-8 单行 JSON 格式 {"locale":"zh-cn"}，且需彻底重启 VS Code 才生效。
locale.json 是 VS Code 唯一生效的语言配置文件，写错任何一处都会静默回退到英文，且不报错。
文件路径必须严格匹配系统平台
VS Code 只读取用户级数据目录下的 User/locale.json，放错位置等于没配：
- Windows：
%APPDATA%\Code\User\locale.json（不是%LOCALAPPDATA%，也不是项目里的.vscode/） - macOS：
$HOME/Library/Application Support/Code/User/locale.json（注意Application Support中间有空格） - Linux：
$HOME/.config/Code/User/locale.json（.config是隐藏目录，不能漏掉点） - Remote-SSH / WSL 下的
locale.json必须在远程端对应路径中单独配置，本地设置完全无效
内容格式容不得半点偏差
哪怕只多一个空格、少一个引号，或用了全角字符，VS Code 就会忽略整个文件：
- 内容只能是单行合法 JSON：
{"locale":"zh-cn"}（小写、短横线、双引号、无逗号、无注释） - 不能写成
{"locale": "zh-cn"}（引号外加空格也不行） - 不能是
{"locale":"zh_CN"}或{"locale":"zh-CN"}（大小写和连字符必须严格为zh-cn） - 不能保存为 UTF-8 with BOM——用 VS Code 自己新建并保存该文件，能天然规避 BOM 问题
编码与文件名大小写敏感
VS Code 对文件名和编码的校验非常严格，出错时不会提示：
- 文件名必须是
locale.json，不能是Locale.json、locale.txt或locale.json.bak - 路径中不能含中文字符或空格（比如
C:\我的软件\Code\User\locale.json会失败） - 编辑器若用记事本、Sublime 或某些 IDE 保存，极易带 BOM 或换行符异常；务必用 VS Code 打开并保存
- 保存后需彻底退出所有 VS Code 进程（Windows 查任务管理器杀光
Code.exe，macOS 活动监视器结束Code Helper），再重开
settings.json 里写 "locale" 完全无效
VS Code 1.70+ 已废弃 settings.json 中的 "locale" 字段，它被静默忽略：
- 无论你写
"locale": "zh-cn"还是"locale": "en"，VS Code 都不读取 - 这个字段不会报错，也不会覆盖
locale.json，但会让你误以为“已经配了” - 插件开发、多工作区场景下，有人误把
"locale"写进工作区.vscode/settings.json，结果重启后毫无反应——因为 VS Code 根本不看那里
真正容易被忽略的是：locale.json 生效与否，和语言包是否已安装、命令面板是否能搜到 zh-cn、右下角状态栏是否显示 en 都没有直接关系——它只认路径、文件名、编码、JSON 结构这四样东西。缺一不可。
