--prefer-dist 能加速安装，它优先从包的发布版本（如 GitHub Releases 归档）拉取代码，而非克隆完整 Git 仓库，从而减少 git 操作、降低下载体积与 IO 压力；但仅在包提供 dist 信息时生效，否则自动回退至 source。
什么是 --prefer-dist，它真能加速安装？
是的，--prefer-dist 会让 Composer 优先从包的发布版本（如 GitHub 的 releases 归档 ZIP/TAR）拉取代码，而不是克隆完整 Git 仓库。对绝大多数生产环境来说，这省去了 git clone、检出分支、解析提交历史等开销，下载体积更小、解压更快、IO 压力更低。
但注意：它只在包明确提供了 dist 信息时生效（即 composer.json 中有 "dist" 字段，或 Packagist 自动从 GitHub/GitLab 发布页提取）。如果包没发版、只有 dev-master 这类开发分支，Composer 会自动 fallback 到 --prefer-source，此时加 --prefer-dist 无效。
什么时候该加 --prefer-dist，什么时候不该加？
加它，适合这些场景：
- CI/CD 流水线中执行
composer install—— 避免反复 clone 同一仓库，节省构建时间 - 部署到生产服务器前的离线打包（配合
composer install --no-dev --optimize-autoloader） - 本地首次安装依赖，且你确认所有依赖都有稳定 release 版本（比如
monolog/monolog:^2.0）
不该加的情况：
- 你在调试某个包的未发布功能，需要修改其源码并提交 PR —— 此时必须用
--prefer-source才能获得可编辑的 Git 工作目录 - 依赖中混用了
dev-xxx分支或path类型仓库 ——--prefer-dist对它们无意义，Composer 会忽略该参数 - 你启用了
COMPOSER_PREFER_SOURCE=1环境变量 —— 它会强制覆盖命令行参数
--prefer-dist 和 config 设置的关系
你可以把它设为全局默认，避免每次敲命令都加：
composer config -g prefer-dist true
但这不推荐用于开发机，因为会干扰你日常调试依赖源码的流程。更稳妥的做法是按需启用：
- CI 脚本里显式写：
composer install --prefer-dist --no-dev --optimize-autoloader - 项目级配置（仅影响当前项目）：
composer config prefer-dist true，配置写入项目根目录下的composer.json的"config"段 - 临时禁用已配置的
prefer-dist：composer install --prefer-source（优先级更高）
注意：composer update 默认行为就是 --prefer-dist，除非你手动指定 --prefer-source 或配置了 prefer-source。
常见误判：为什么加了 --prefer-dist 还在 git clone？
这不是参数失效，而是 Composer 在告诉你：“这个包根本没 dist 可下”。典型原因包括：
- 包作者没打 GitHub Release（只有
main/master分支），Packagist 拿不到dist.url - 你锁定了
"dev-develop"这种分支别名，Composer 认为这是开发态，直接走 source - 包的
composer.json显式声明"source"但没写"dist"，或者"dist"的 URL 返回 404 - 你运行的是
composer require some/package:dev-main——dev-前缀会强制 source
验证方式：执行 composer show some/package，看输出里 dist 行是否存在且 URL 可访问；或者加 -v 参数运行安装命令，观察日志中是 Downloading... 还是 Cloning...。
真正影响速度的，往往不是参数本身，而是你是否清楚每个依赖的发布状态和版本约束写法。
