直接连接 packagist.org 导致生产环境部署缓慢，是许多开发者遇到的常见性能瓶颈。很多人第一反应归结为“网络差”，但实际原因往往更加复杂——DNS 解析失败、TLS 握手异常、CDN 节点超时，这三层中任意一环出现问题，Composer 就会反复重试，白白浪费数分钟时间。使用中文镜像后，部署速度通常大幅提升，composer install 从 3–5 分钟缩短到 20–40 秒已成常态。不过，前提是镜像配置正确且参数匹配。
为何修改镜像地址后仍卡在 Resolving dependencies 阶段？
这个阶段卡住，其实与镜像本身无关。镜像只负责加速包的下载和元数据获取，并不参与依赖解析。真正拖慢进度的，是 Composer 的 SAT 求解器在本地穷举所有可能的版本组合。典型诱因包括：
composer.json中 PHP 版本约束设置过于宽泛，例如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，导致 SAT 求解器需要穷举大量版本组合才能找到可行解minimum-stability设置为dev，强制拉取大量不稳定分支，大幅膨胀了依赖搜索空间，延长解析时间composer.lock被删除或未提交到仓库，导致install命令退化为update，重新执行完整的依赖解析流程- 项目
repositories中配置了已下线的私有源，Composer 会逐一尝试连接直至超时，然后才回退到镜像源
必须正确配置 repo.packagist，否则镜像不生效
90% 的“换源无效”问题，根源在于键名、类型和 URL 格式这三个关键要素。任何一处细节不符，镜像都会静默失效：
- 键名必须严格为
repo.packagist，如果多写一个 s 变成repos.packagist，Composer 会直接忽略该配置 - type 值必须显式指定为
composer，在命令中不得省略 - URL 末尾必须包含
/，例如https://mirrors.aliyun.com/composer/是正确的；若缺少斜杠会拼接出/p2//路径，导致 404 错误
验证方法十分简单：执行 composer config -g repo.packagist，输出必须为完整的 JSON 格式，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
部署脚本缺失这些参数，镜像提速效果大打折扣
仅更换镜像还不够。在 CI/CD 环境中，必须附加以下参数，才能充分释放镜像的性能潜力：
--no-interaction：避免因缺少 TTY 而停滞在交互提示上--prefer-dist：强制下载 ZIP 包，跳过耗时的git clone操作--no-dev：跳过require-dev中的依赖，可节省 30% 至 60% 的部署时间--optimize-autoloader与--classmap-authoritative：生成类映射并禁用文件扫描，运行时性能更佳，且不影响部署耗时
推荐的 CI 部署命令为：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress
私有包与镜像能否共存？
完全可以，无需额外配置。镜像配置仅影响 packagist.org 官方源，对 repositories 中定义的 VCS、path、Satis 等私有源完全透明，无冲突。
但有两个细节需留意：第一，composer.json 顶层的 "packagist.org": false 会禁用所有官方包，必须删除或设置为 true；第二，如果已配置私有源，不应使用 composer config repo.packagist 全量覆盖 repositories，而应手动编辑，或让 Composer 自动追加。
