composer install卡在loading composer repositories是元数据拉取失败，需三步解决：确认镜像url正确（如https://mirrors.aliyun.com/composer/末尾带/）、执行composer clear-cache清旧缓存、用curl验证镜像地址返回合法json。
composer install 卡在 Loading composer repositories 怎么办
这几乎 100% 是元数据拉取失败，不是网络差，也不是项目本身有问题。Composer 启动时会先全量请求 packages.json（约 20MB+），这个接口走 HTTPS，受 DNS 解析、TLS 握手、CDN 节点距离影响极大。
直接执行以下三步，90% 场景立刻解决：
- 确认镜像 URL 正确：
composer config -g repo.packagist输出必须是完整 JSON，且url字段末尾有且仅有一个/，例如"https://mirrors.aliyun.com/composer/"；漏掉斜杠会导致 404 或静默 fallback 到官方源 - 清旧缓存：
composer clear-cache，否则它仍用 packagist.org 的旧元数据，镜像等于白配 - 验证镜像可用性：手动 curl
https://mirrors.aliyun.com/composer/packages.json，看是否返回合法 JSON（非 404/空响应）
全局镜像配置为什么有时不生效
根本原因不是命令错了，而是配置没落到真正执行命令的用户身上。composer config -g 写的是当前用户的 ~/.composer/config.json（Windows 是 C:\Users\用户名\AppData\Roaming\Composer\config.json），但实际运行环境可能完全不同。
常见失效场景：
- 宝塔面板「一键部署」是以
www用户身份运行，你用管理员账户配的全局镜像对它无效 - CI 脚本里用
sudo composer config -g，写进了root的配置，而构建容器里跑的是runner用户 - 拼写错误如
repos.packagist（多一个s）会静默写入无效字段，composer config -g repo.packagist查出来为空，但命令不报错
排查方法：在目标环境下直接执行 composer config -g repo.packagist，看输出是否符合预期。
项目级镜像配置比全局更可靠吗
是的，尤其适合团队协作和 CI/CD 场景。项目级配置写进 composer.json 的 repositories 字段，可提交到 Git，所有人行为一致。
正确操作方式：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会安全 merge 进
repositories对象，不会覆盖已有私有源（如 GitLab 私仓） - 如果
composer.json里repositories是数组格式（[]），命令会失败，需先手动改成对象{} - 别手写
"packagist.org": false——这会彻底关掉官方源，镜像临时不可用时composer install直接失败
装完 Composer 就算完事？加速参数必须立刻配
只装上 composer 命令，不配加速项，后续每次 install 都可能卡在 downloading，实际耗时比安装本身长 10 倍。
新装完必须马上执行：
- 换镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 开并行下载（Composer 2.2+）：
composer config -g parallel-downloads 10 - 强制 dist 模式：
composer config -g prefer-dist true - 最后清缓存：
composer clear-cache
验证：composer config -g repo.packagist、composer config -g parallel-downloads、composer config -g prefer-dist 三个命令都应输出对应值。项目里若存在 "prefer-source": true，它会覆盖全局 prefer-dist，必须手动删掉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
