换国内镜像可显著提升 Composer 下载速度，因默认源 packagist.org 位于欧洲，受 DNS 污染、路由绕行及 TLS 握手慢影响，导致 download 卡顿或超时；推荐全局配置阿里云镜像（https://mirrors.aliyun.com/composer/）以获稳定低延迟同步。
Composer 默认走国外源，国内直连经常超时或卡死，换国内镜像能立竿见影提速，但不是所有镜像都稳定，也不是所有项目都能无脑切。
为什么 composer install 卡在 Downloading... 或报 Connection timed out
本质是 Composer 默认使用 packagist.org（位于欧洲），国内访问受 DNS 污染、路由绕行、TLS 握手慢等影响。常见表现包括：
- 执行
composer install或composer update时长时间停在某个包的下载阶段 - 报错如
file_get_contents(): SSL operation failed或cURL error 28: Operation timed out - 即使能连上，单个包下载也要几十秒甚至几分钟
这不是你网络差，而是源站物理距离和中间链路导致的——换镜像前先确认是否真卡在这步，避免误判为代码或依赖问题。
推荐用 composer config -g repo.packagist 全局设阿里云镜像
阿里云镜像（https://mirrors.aliyun.com/composer/）目前最稳，同步延迟低（通常
立即学习“PHP免费学习笔记（深入）”；
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意几个关键点：
- 必须加
-g（global），否则只对当前目录生效，新项目还得重设 -
repo.packagist是 Composer 8+ 的写法；若用 Composer 1.x，请改用packagist（不带repo.前缀） - 设完后可运行
composer config -g repo.packagist验证是否写入成功 - 如果公司内网有自建镜像，优先用内网地址，避免公网带宽争抢
遇到 Package not found 或 Could not find package 怎么办
不是所有镜像都 100% 同步，尤其小众包、刚发布的版本或私有包。排查顺序如下：
- 先运行
composer clear-cache清掉本地缓存，避免旧索引干扰 - 临时切回官方源测试：
composer config -g repo.packagist composer https://packagist.org，看是否能正常安装 - 确认包名拼写正确，比如
monolog/monolog不是monolog；有些包已迁移到新命名空间，需查 Packagist 页面 - 若确定是镜像同步滞后，可等几小时再试，或手动指定该包走官方源：
composer config repositories.packagist composer https://packagist.org（仅针对特定包，不推荐长期用）
CI/CD 流水线里别硬编码镜像地址
在 GitHub Actions、GitLab CI 等环境里，直接写死 composer config -g 可能引发权限或缓存污染问题。更稳妥的做法是：
- 用
COMPOSER_REPO_PACKAGIST环境变量覆盖，例如：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 在
composer.json里加repositories字段（仅限当前项目）：
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
这样既不影响本地开发配置，又避免 CI 脚本耦合镜像地址。另外，Docker 构建时建议把镜像设置写进 Dockerfile 的 RUN 指令，而不是靠构建机全局配置——后者不可控。
镜像只是加速手段，不是万能解药。真正拖慢 Composer 的，有时是锁文件过期、PHP 扩展缺失、或 require-dev 里一堆调试工具。换完镜像还慢？先跑 composer diagnose 看诊断结果，别急着换第二个镜像。
