改阿里云镜像源、加 parallel-downloads、关 classmap-authoritative 可解决90% Composer 慢问题；关键需验证 packages.json 是否真从国内拉取，常见原因有配置拼写错误、未清缓存、使用失效旧地址。
直接换阿里云镜像源，加 parallel-downloads 并关掉 classmap-authoritative，90% 的慢不是网络问题，是 Composer 自己在本地反复扫描和重算。
为什么改了镜像还是慢？关键看 packages.json 是否真从国内拉
很多人执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就以为搞定了，但实际日志里还在请求 https://packagist.org/packages.json——说明配置没生效或 fallback 了。原因常见有三：
-
repos.packagist拼写错成repo.packagist（少了个s），导致配置被忽略 - 配置后没清缓存：
composer clear-cache必须跟上，否则旧缓存仍会尝试走官方源 - 镜像 URL 已失效：阿里云镜像近期已统一为
https://mirrors.aliyun.com/composer/，别用带phpcomposer.com或laravel-china.org的老地址（后者已停更）
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 URL；再跑 composer install -vvv，观察最后几行是否出现 Reading packages.json from cache 且路径含 aliyun。
composer install 卡在 “Resolving dependencies through SAT” 怎么办
这不是下载慢，是 Composer 在暴力穷举版本组合。尤其当你用了宽泛约束（如 "monolog/monolog": "^1.0 || ^2.0"、"php": ">7.4"）或含大量 dev-main 包时，SAT 求解器可能卡住几分钟甚至失败。
- 优先用
composer install而非update：只要composer.lock存在且没动过composer.json，它根本不解析，直接装 - 真要更新某包？明确指定：
composer update monolog/monolog，避免全量重算 - 收紧 PHP 版本声明：
"php": "^8.1"比">=7.4"少查几百个包的兼容性元数据 - 临时绕过求解器：
composer update --with-all-dependencies（CI 场景可用，不校验子依赖兼容性）
为什么 vendor 目录已存在，composer update 还巨慢
Composer 3.x 默认开启 classmap-authoritative 模式，每次 update 都强制重扫整个 vendor 目录生成 classmap，哪怕只更新一个包。这纯属本地 I/O 和 PHP 解析开销，和网络无关。
- 关掉它：
composer config authorative false（注意拼写是authorative，不是authoritative） - 或删掉
composer.json里的"optimize-autoloader": true - 如果必须保留优化 autoload，改用
composer dump-autoload --optimize手动触发，而不是让update自动干
另外，composer install --no-dev --prefer-dist --optimize-autoloader 这组参数在生产部署时几乎必加，但开发阶段慎用 --classmap-authoritative——新增类不会被自动加载器发现，调试时容易误判为“代码没生效”。
Docker 或 CI 中怎么避免重复慢操作
容器环境里最容易踩两个坑：一是每次构建都重新配镜像，二是挂载 vendor 目录到宿主机导致 I/O 延迟爆炸。
- Dockerfile 里提前配镜像：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，别等 RUN composer install 时才配 - 禁止挂载
vendor/：在docker-compose.yml的volumes里删掉对vendor的映射，让composer install在容器内本地执行 - CI 中跳过无用环节：
composer install --no-dev --no-scripts --no-autoloader，后续用composer dump-autoload --optimize补一次即可 - 缓存目录挪 SSD：
composer config -g cache-dir /tmp/composer-cache（前提是容器里/tmp是内存盘）
最常被忽略的是：composer create-project 默认会执行 install 并生成 autoload，其实你只是想拿个空壳。加 --no-install 跳过，进目录后再按需装——这能省掉几十秒到几分钟不等。
