--prefer-dist 通常更快是因为下载预构建压缩包，体积小、无 Git 历史、解压即用；但私有包缺 dist 配置、镜像未同步或无 dist 包时会降级或失败。
composer create-project --prefer-dist 确实能显著加快项目初始化，但它的加速效果高度依赖网络环境与包的发布配置，并非在所有场景下都比 --prefer-source 快。
为什么 --prefer-dist 通常更快？
Composer 默认会尝试下载预构建的压缩包（.zip 或 .tar.gz），而不是克隆完整 Git 仓库。压缩包体积小、无需 Git 历史、解压后即用。
- 跳过 Git 克隆、检出、子模块初始化等开销
- CDN 分发的 dist 包通常有更高下载带宽
- 适合 CI/CD 构建或本地快速搭建 demo
哪些情况下 --prefer-dist 反而更慢甚至失败？
当包未正确配置 dist 发布信息，或镜像源缺失对应压缩包时，Composer 会退回到 --prefer-source 行为，甚至报错中断。
- 私有包未在
composer.json中声明dist字段（如url、shasum） - 使用了国内镜像（如阿里云、腾讯云），但镜像尚未同步最新 dist 包（常见于新发布的 minor 版本）
- 遇到
Could not fetch https://xxx.zip, please review your configured sources类错误 - 某些包（如 Laravel 的 nightly 构建）根本没提供 dist 包，强制
--prefer-dist会直接失败
如何确认当前包是否真走 dist 流程？
加 -v 参数观察输出，关键看是否出现 Downloading (connecting...) 后接压缩包 URL，而非 Cloning [commit hash]。
composer create-project laravel/laravel myapp --prefer-dist -v
若看到类似以下日志，说明走的是 dist：
Downloading https://api.github.com/repos/laravel/laravel/zipball/123abc...Downloading https://codeload.github.com/laravel/laravel/legacy.zip/123abc...
若看到 Cloning https://github.com/laravel/laravel.git，说明已 fallback 到 source。
加速更稳的组合策略
单纯依赖 --prefer-dist 不够可靠；实际项目中建议配合以下操作：
- 确保
composer config -g repo.packagist composer https://packagist.phpcomposer.com（或对应国内镜像）已生效 - 对私有包，在
composer.json的repositories中显式指定type: "package"并填全dist字段 - CI 环境可加
--no-interaction --no-scripts减少干扰，再配合--prefer-dist - 若频繁遇到 dist 缺失，临时改用
--prefer-source --no-dev反而更省心——尤其在调试依赖结构时
dist 是优化手段，不是契约；Composer 的 fallback 机制本身就有不确定性，别把它当成“必快开关”。真正影响速度的，往往是镜像源稳定性与包作者是否认真维护 dist 元数据。
