Composer安装依赖慢？配置国内镜像源解决

Composer安装依赖慢往往并非网络问题，而是本地配置不当或默认行为导致的“伪慢”：镜像源配置错误、缓存未清理、过时URL失效、SAT依赖解析过度穷举、classmap-authoritative强制全量扫描vendor、Docker/CI中重复配置与I/O瓶颈等共同拖垮效率；只需精准替换为阿里云镜像、启用parallel-downloads、关闭authoritative模式、验证packages.json真实来源，并结合场景优化命令参数（如用install代替update、收紧PHP版本约束、跳过dev依赖与脚本），90%的卡顿即可迎刃而解——真正快起来的关键，从来不在下载速度，而在让Composer少做无用功。

直接换阿里云镜像源，加 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 跳过，进目录后再按需装——这能省掉几十秒到几分钟不等。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Composer安装依赖慢？配置国内镜像源解决》文章吧，也可关注golang学习网公众号了解相关技术文章。