locale.json必须放在用户级配置目录而非settings.json;VS Code 1.70+仅读取该独立文件,路径需严格匹配系统目录,内容仅允许{"locale":"zh-cn"}且格式必须合法。

locale.json 文件必须放在用户级配置目录,不是 settings.json
VSCode 从 1.70 版本起,locale 配置已完全移出 settings.json,写在那里毫无作用。它只读取独立的 locale.json 文件,且路径必须严格对应操作系统和用户数据目录。很多人改了 settings.json 还是英文,就是卡在这一步。
常见错误包括:
- 把文件放到工作区目录或项目根目录下(VS Code 不会读)
- 路径拼错,比如写成
%APPDATA%\Code\locale.json(漏了User\) - 文件名写成
locale.js、local.json或locale.json.txt
内容格式必须是合法 JSON,且仅含 {"locale":"zh-cn"}
locale.json 不是配置模板,它只承担一个任务:告诉 VS Code 当前界面语言。任何多余字符都会导致失效。
正确写法只有这一行(注意细节):
{"locale":"zh-cn"}
容易踩的坑:
- 值用了大写或下划线:
"zh_CN"、"ZH-CN"、"Chinese"全无效 - 加了空格:
{"locale": "zh-cn"}(冒号后多空格)在某些编辑器里会触发解析失败 - 保存为 UTF-8 with BOM 编码——Windows 记事本默认干这事,VS Code 会静默忽略该文件
- 文件末尾多了换行或逗号,JSON 不合法
重启必须彻底,后台进程残留会导致配置不加载
点「Reload Window」没用,它不会重读 locale.json。必须关闭所有窗口,并确认后台进程已退出。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
检查方式:
- Windows:打开任务管理器,结束所有
Code.exe进程(包括后台服务类) - macOS:活动监视器中搜索
Electron或Code Helper,全部退出 - Linux:运行
pkill -f 'code'或查ps aux | grep code
重启后,右下角状态栏会显示当前语言代码(如 zh-cn),点击它可快速验证是否生效。
Remote-SSH / WSL 环境要单独配 locale.json
本地设好了中文,远程连接后还是英文?因为 Remote-SSH 和 WSL 启动的是远程机器上的 VS Code Server 实例,它读的是远程路径下的 locale.json,和本地完全无关。
操作路径:
- 在 WSL 终端中进入:
~/.vscode-server/data/Machine/(后面可能带哈希后缀) - 在该目录下新建或编辑
locale.json,内容仍是{"locale":"zh-cn"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口)
真正容易被忽略的是:终端、调试控制台、Git 输出、部分插件界面默认不随 locale 变——那是它们各自的语言环境,不是 VS Code 汉化失败。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处对了,就是真汉化成功。

















