locale.json必须放在用户数据目录的User子目录下，路径因系统而异：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"}，格式错误则静默忽略；修改后需彻底退出VS Code并杀掉后台进程才能生效，Remote-SSH/WSL需单独配置远程端对应路径。
locale.json 文件必须放在用户数据目录下
VS Code 只读取特定路径下的 locale.json，放错位置就完全无效。它不认工作区里的 .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
注意：User 目录必须存在，locale.json 文件名大小写敏感，不能是 Locale.json 或 locale.txt。
文件内容只能是严格的一行 JSON
locale.json 不是 settings.json，不支持注释、多余空格、逗号或嵌套字段。VS Code 遇到任何格式错误就静默忽略整份文件，界面继续英文。
合法内容只有一行，且必须完全匹配：
{"locale":"zh-cn"}
常见错误包括：
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 写成
"locale": "zh_CN"（下划线无效） - 漏掉外层花括号，只写
{"locale":"zh-cn"}（少一个}） - 用记事本保存带 BOM 的 UTF-8（推荐用 VS Code 自己新建并保存）
- 在
settings.json里加"locale": "zh-cn"（该字段已废弃，VS Code 1.70+ 完全不识别）
改完必须彻底退出再重启
“重载窗口”（Developer: Reload Window）不会重读 locale.json，必须关闭所有窗口并杀掉后台进程。
验证是否关干净：
- Windows：打开任务管理器，确认没有
Code.exe进程残留 - macOS：活动监视器中搜索
Electron或Code Helper，全部退出 - Linux：运行
ps aux | grep code，确保无残留进程
重启后，右下角状态栏会显示当前语言代码（如 zh-cn），点击它可快速切换——这是最直接的生效证据。
Remote-SSH / WSL 环境要单独配
本地设好了 locale.json，连上远程机器还是英文？不是配置错了，而是 Remote-SSH 和 WSL 启动的是另一个独立的 VS Code Server 实例，它读的是远程机器上的配置。
操作路径不同：
- Remote-SSH：连接后按
Ctrl+Shift+P→Developer: Open User Data Folder→ 进User/目录编辑locale.json - WSL：终端执行
code --list-extensions确保服务已启，再进~/.vscode-server/data/Machine/xxx/User/locale.json（xxx 是哈希后缀）
远程端的语言包也得单独安装，本地插件不会自动同步过去。
