vs code 设置中文必须通过 locale.json 文件实现,路径为 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"},utf-8 无 bom 编码,且需彻底退出所有进程后重启生效。

locale.json 文件路径和创建方式
VS Code 只读取特定路径下的 locale.json,且该文件必须存在、格式合法、编码正确。它不从 settings.json 读取 locale 字段,所以别往那里写。
关闭所有 VS Code 窗口后,用任意文本编辑器(推荐用 VS Code 自己)打开对应路径的文件:
- 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"}
注意:双引号、冒号、逗号必须是英文符号;不能有多余空格、换行或逗号;不能写成 zh_CN、zh-hans、Chinese 或 zh——这些全无效。
UTF-8 无 BOM 编码是硬性要求
VS Code 对 locale.json 的编码极其敏感。哪怕文件内容完全正确,只要带了 BOM(字节顺序标记),它就会静默忽略整份配置,回退到英文界面。
在 VS Code 中保存时,请确认右下角显示的是 UTF-8,而不是 UTF-8 with BOM。若显示后者,点击它 → 选择 Save with Encoding → 选 UTF-8。
其他编辑器(如记事本)默认可能加 BOM,务必避免。用命令行验证是否含 BOM:
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
head -c 3 locale.json | hexdump -C
输出中若出现 ef bb bf,说明有 BOM,需重存为无 BOM 版本。
重启必须彻底,否则配置不加载
改完 locale.json 后,不能只点 “重新加载窗口” 或快捷键 Ctrl+Shift+P → Developer: Reload Window。VS Code 的语言上下文是在进程启动时初始化的,中途不会重读 locale.json。
必须确保所有相关进程已退出:
- Windows:打开任务管理器,结束所有
Code.exe进程(包括后台的Code Helper (Renderer)) - macOS:打开活动监视器,搜索并强制退出
Electron和Code Helper - Linux:运行
pkill -f "code.*--no-sandbox"或手动查杀code相关进程
再全新启动 VS Code,顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 显示值为 zh-cn,才算真正生效。
为什么改了还是英文?优先排查这三处
常见失效不是因为操作错,而是被其他因素覆盖或阻断:
-
locale.json路径错误:比如误存到.vscode工作区目录下,或写成了settings.json - 文件内容含不可见字符:全角引号、中文冒号、输入法残留空格,都会导致 JSON 解析失败
- 企业策略或某些主题插件(如旧版
vscode-theme-onedark)通过注册表或策略文件锁定了语言,此时locale.json会被无视
最稳验证方式:启动后右下角状态栏会显示当前语言代码(如 en 或 zh-cn),点击它可快速切换——如果这里始终是 en,说明进程根本没读到你写的 locale.json。










