必须严格使用用户级路径和{"locale":"zh-cn"}格式:Windows为%APPDATA%\Code\User\locale.json,macOS为~/Library/Application Support/Code/User/locale.json,Linux为~/.config/Code/User/locale.json,内容须为无空格、无注释、UTF-8无BOM的一行合法JSON,且仅通过Configure Display Language命令生成并重启生效。

locale.json 文件路径写错就完全失效
VS Code 只读取**用户级**的 locale.json,其他任何位置写的都白搭。它不看工作区目录、不读系统级配置、也不认 settings.json 里的 "locale" 字段。
必须严格匹配以下三者之一:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
常见错误包括:把文件放到 .vscode/ 下、放在插件目录里、或误存为 locale.json.txt;哪怕路径只差一个 User,VS Code 就静默回退英文。
locale.json 内容格式极其敏感
这个文件不是“差不多就行”的配置,而是“错一个字符就失效”的校验型文件。它只接受一行纯 JSON,且必须满足全部条件:
- 内容只能是:
{"locale":"zh-cn"}(注意双引号是英文、小写、短横线) - 不能有注释、不能有逗号结尾、不能多空格、不能用全角标点
- 编码必须是 UTF-8 无 BOM——用记事本保存极易带 BOM,推荐用 VS Code 自己新建并保存
- 不能写成
zh_CN、zh-hans、Zh-cn或"zh-cn "(末尾空格)
如果文件已存在但内容杂乱,直接清空,只留那一行,保存即可。别试图“修”旧内容,重写更可靠。
Configure Display Language 命令没真执行
这个命令不是可选项,是唯一能安全生成合规 locale.json 的入口。跳过它,等于没打开中文开关。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
常见假执行现象:
- 只装了插件,没按
Ctrl+Shift+P(或Cmd+Shift+P)输全名Configure Display Language - 输入时拼错大小写或空格,导致匹配不到命令
- 列表里点了
zh-CN或Chinese (Simplified),但实际只有zh-cn是有效项 - 弹出提示后点了
Don’t Restart,或只关窗口再手动开——这不会重载语言环境
正确流程:输全命令 → 明确选 zh-cn → 点 Restart 按钮 → 等待所有进程退出(托盘图标消失)再启动。
工作区或远程环境覆盖用户设置
VS Code 的语言设置有明确优先级:启动参数 > 工作区 .vscode/settings.json > 用户 locale.json。你改对了用户级,不代表界面就一定中文。
排查要点:
- 检查当前项目根目录下是否有
.vscode/settings.json,里面是否含"locale": "en"这类字段 - Remote-SSH / Dev Container 场景下,本地
locale.json对远程窗口无效;需登录远程终端,在对应路径下单独配一份 - 启动快捷方式或终端 alias 里是否带了
--locale=en参数?它会强制覆盖所有配置 - 企业环境中,GPO 或策略插件可能锁死
locale,此时手动改文件也无效
最简单的验证方式:关闭当前文件夹(File > Close Folder),再运行 Configure Display Language,看是否立即生效。

















