vscode仅读取用户级locale.json文件,路径为windows:%appdata%\code\user\locale.json、macos:~/library/application support/code/user/locale.json、linux:~/.config/code/user/locale.json;必须用vs code新建并保存为utf-8无bom编码,内容严格为{"locale":"zh-cn"},且需彻底退出所有进程后重启才生效。

locale.json 文件路径和创建方式
VSCode 只读取用户级 locale.json,不认工作区或系统级配置。文件不存在时需手动新建,不能靠命令面板生成(1.80+ 版本已移除相关逻辑)。路径必须严格对应系统:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
用 VS Code 自己打开该路径并新建文件最稳妥——避免编码问题;保存时选 UTF-8 无 BOM,否则可能静默失效。
locale.json 内容格式必须零错误
VSCode 对 JSON 格式极其敏感,任何偏差都会导致整个文件被跳过,回退到上一次有效设置(比如残留的中文)。只接受且仅允许以下形式:
{"locale":"en"} 或 {"locale":"zh-cn"}
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
常见失效写法(全部无效):
-
{'locale':'en'}(单引号) -
{"locale":"EN"}或{"locale":"en-us"}(大小写/连字符错误) -
{"locale":"zh-cn",}(尾部逗号) -
{"locale":"zh-cn" }(值后空格) -
// 注释或换行缩进
改完 locale.json 为什么还是没变
VSCode 启动时按优先级加载语言设置:启动参数 > 工作区 .vscode/locale.json > 用户级 locale.json。容易忽略的覆盖源:
- 当前项目根目录下存在
.vscode/locale.json→ 直接删掉它 - 终端 alias 启动(如
alias code='code --locale=zh-cn')→ 检查~/.zshrc或~/.bashrc - Remote-SSH 连接远程机器 → 本地改了没用,得登录远程主机删其
locale.json - Windows 组策略或注册表锁定 UI 语言 → 检查
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced\PreferredUILanguages
必须彻底退出 VSCode 才能生效
“重启窗口”(Reload Window)或 Ctrl+R 完全无效。必须杀掉所有进程:
- Windows:任务管理器中结束全部
Code.exe和Code Helper进程 - macOS:执行
killall -u $USER 'Code Helper',再检查 Activity Monitor - Linux:运行
pkill -f 'code',确认无残留
托盘图标还在?说明没杀干净。这是最常被跳过的步骤,也是 90% “改了没反应” 的真实原因。










