Composer install卡在“Loading composer repositories”主因是国内无法稳定直连packagist.org，应执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/切换镜像并运行composer clear-cache清缓存，再验证curl -I https://packagist.org/packages.json连通性。
为什么composer install总卡在packagist.org？
国内直接访问packagist.org常因网络波动或DNS污染导致超时、404或解析失败，表现为composer install卡在“Loading composer repositories”或反复重试后报错Could not fetch https://packagist.org/packages.json。这不是你项目配置的问题，是源站物理距离和路由导致的常态。
解决思路不是调大超时或重试次数，而是换源——把默认的packagist.org替换成响应快、同步及时的中文镜像。
- 推荐使用
https://packagist.phpcomposer.com（阿里云维护，已稳定运行多年）或https://mirrors.aliyun.com/composer/（阿里云官方镜像，更新更及时） - 避免用已停更的镜像（如旧版
https://packagist.phpcomposer.com域名已失效，需确认当前可用地址） - 镜像不是100%实时同步，但延迟通常在5分钟内，不影响日常开发
全局替换镜像源：一次设置，所有项目生效
执行以下命令即可永久切换全局源，后续所有composer install、composer update都会走镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
立即学习“PHP免费学习笔记（深入）”；
composer config -g repo.packagist
输出应为https://mirrors.aliyun.com/composer/。若提示Cannot use 'repo.packagist' as it is reserved，说明你用的是较新版本Composer（2.2+），需改用：
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
- 全局配置写入
~/.composer/config.json，对所有用户项目生效 - 如果团队协作，建议在项目根目录单独配
composer.json里的repositories字段，避免依赖个人环境 - 切记不要在
composer.json中同时写多个packagist源，Composer只认第一个
临时切换源：仅本次命令生效
调试或验证镜像可用性时，不改动任何配置，直接加--repository参数：
composer install --repository=https://mirrors.aliyun.com/composer/
或者更简洁地用-r：
composer install -r https://mirrors.aliyun.com/composer/
- 该方式优先级高于全局配置，适合CI/CD脚本中强制指定源
- 注意：部分老版本Composer不支持
--repository参数，会报Unknown option，此时只能先全局配置再运行 - 临时源不会影响
composer.lock生成逻辑，锁文件仍记录原始包名和版本，只是下载路径变了
镜像失效或同步滞后怎么办？
偶尔遇到镜像未同步新包（比如某包刚发布，镜像还没拉取），composer require报Package x/y not found，但确认原包存在。这时别急着换源，先做三件事：
- 检查镜像状态页：
https://mirrors.aliyun.com/composer/status.html，看是否有同步延迟告警 - 清除本地缓存：
composer clear-cache，避免旧元数据干扰 - 临时回退到官方源单次安装：
composer install -r https://packagist.org，成功后再切回镜像
真正麻烦的不是镜像挂了，而是你忘了它只是缓存层——所有包最终都来自packagist.org，所以私有包、GitHub仓库直连等非Packagist托管的依赖，镜像完全不代理，这类依赖仍需确保网络可达。
