必须换国内镜像源，执行composer config -g repo.packagist确认URL为https://mirrors.aliyun.com/composer/等国内地址，为空或仍显示packagist.org则未生效；旧版需用repos.packagist配置，项目级repositories会覆盖全局设置；-vvv日志可验证实际下载域名；resolving dependencies卡顿主因是PHP内存不足、xdebug启用、platform不匹配或composer.lock残留；应改用http-max-concurrent-downloads 10替代已弃用的parallel-downloads；CI中须组合使用--no-dev --prefer-dist --no-autoloader --no-scripts并缓存~/.composer/cache。
国内环境下 Composer 下载慢，不是网络差，是默认直连欧洲的 packagist.org 导致 TLS 握手超时、DNS 解析慢、首字节延迟高；换镜像不是“试试看”，而是必须做的第一步，否则 composer install 卡在 Downloading 是常态。
怎么确认当前用的是哪个镜像源
执行 composer config -g repo.packagist，输出应为类似 "https://mirrors.aliyun.com/composer/" 的 URL。如果为空、null 或仍是 "https://packagist.org"，说明镜像没生效。
- 旧版 Composer（1.x）不识别
repo.packagist，需改用composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 项目级
composer.json中若定义了repositories，会覆盖全局配置——此时要删或改项目配置，不能只调全局 - 加
-vvv运行composer install，日志里出现mirrors.aliyun.com或mirrors.cloud.tencent.com才算真走镜像
阿里云 / 腾讯云 / 华为云镜像实测差异（2026年7月）
三家都能显著提速，但同步时效、路径格式、区域稳定性不同，选错会导致 require 找不到新包、404 或偶发 502：
-
https://mirrors.aliyun.com/composer/：唯一全量每分钟同步源，新包如laravel/framework v11.0.0通常 2 分钟内可拉到；末尾斜杠 必须保留，漏写会报Could not parse version constraint -
https://mirrors.cloud.tencent.com/composer/：南方用户稳定，但新包平均延迟 1–3 小时；偶发索引未更新，导致composer update找不到最新版 -
https://mirrors.huaweicloud.com/repository/php/：路径含/repository/php/，漏写/php/直接 404；部分区域 CDN 响应稍慢，但保留历史版本更全
CI/CD 构建时哪些参数必须加
镜像再快，没配对参数也白搭。微服务 CI 流水线卡顿，90% 出在没加这几项：
-
--prefer-dist：强制下载 ZIP 包，跳过git clone，对 Laravel/Symfony 类框架提速 2–5 倍 -
--no-dev：生产镜像完全不需要phpunit、laravel/pint等，少拉 20+ 包，显著减少网络 IO 和解压时间 -
--no-interaction：避免 CI 卡在 license 确认等交互提示，必须配合使用 -
--no-autoloader：CI 阶段不生成 autoload 文件，留到构建后容器启动前再跑composer dump-autoload -o，省掉每次构建的类扫描开销
为什么换了镜像还卡在 Resolving dependencies
这个阶段不走网络，但严重受 PHP 环境影响。镜像只加速下载，不解决解析卡顿：
-
memory_limit过低（如 128M）：运行COMPOSER_MEMORY_LIMIT=-1 composer install强制不限内存 - 启用了
xdebug：执行php -v看输出是否含xdebug，有就临时禁用，否则依赖解析慢 5–10 倍 -
platform配置与实际 PHP 版本不匹配（如"php": "7.4"却在 PHP 8.2 上运行），触发降级查找逻辑 -
composer.lock残留已下线包的引用，导致回退搜索——删掉vendor/和composer.lock，再跑composer install --no-cache
最容易被忽略的是：镜像配置写错一个字符（比如 repos.packagist 多了个 s，或者 URL 少了末尾斜杠），就会静默失效；而 Resolving dependencies 卡住时，第一反应往往是“镜像又崩了”，其实问题根本不在镜像上。
