手动配置locale.json是VS Code汉化最稳兜底方式,路径须精准:Windows为%APPDATA%\Code\User\locale.json,macOS为~/Library/Application Support/Code/User/locale.json,Linux为~/.config/Code/User/locale.json;内容仅一行{"locale":"zh-cn"},UTF-8无BOM编码,且需彻底退出VS Code进程后重启才生效。

手动配置 locale.json 是 VS Code 汉化最稳的兜底方式,只要路径、内容、编码、进程四者全对,100% 生效;其他方法失效时,优先走这一步。
locale.json 文件在哪?路径必须精准
它不在 VS Code 安装目录,也不在项目里,而是存在用户数据目录下。改错位置等于白干:
- Windows:
%APPDATA%\Code\User\locale.json(即C:\Users\用户名\AppData\Roaming\Code\User\locale.json) - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
注意:settings.json 里加 "locale": "zh-cn" 完全无效——VS Code 根本不读这个字段。
文件内容只允许一行合法 JSON
新建或编辑 locale.json 时,内容必须严格为:
{"locale":"zh-cn"}
常见错误包括:
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 写成
{"locale": "zh_CN"}、{"locale": "zh-hans"}或{"locale": "Chinese"}—— 全部静默失败 - 多加了逗号、空格、换行或注释(JSON 不支持注释)
- 保存为 UTF-8 with BOM 编码(会导致解析失败,务必选“UTF-8 无 BOM”)
- 文件里混着其他配置(比如把
locale和telemetry写一起)——整个文件会被忽略
必须彻底退出 VS Code 才能生效
“重新加载窗口”(Reload Window)不重读 locale.json,只重启进程才生效:
- Windows:打开任务管理器,杀掉所有
Code.exe进程(包括后台的 GPU、Renderer 等) - macOS:活动监视器中结束所有
Electron和Code Helper进程 - Linux:运行
pkill -f "code.*--no-sandbox"或手动查杀code相关进程
重启后右下角状态栏会显示 zh-cn,点它可快速验证当前 locale 值。
为什么改完还是英文?盯住三个关键位置
终端、调试控制台、Git 输出显示英文是正常现象——它们不走 VS Code 的 locale 配置,而是依赖系统语言或运行时环境。真正要确认汉化是否成功,只看:
- 顶部菜单栏文字(文件、编辑、视图…)
- 左侧活动栏 hover 提示(如“资源管理器”“搜索”“源代码管理”)
- 设置界面搜索
locale,结果值是否为zh-cn
这三处全中文,说明 locale.json 已正确加载;其余地方仍是英文,不是配置失败,是设计如此。

















