prefer-dist 能加快 Composer 安装，因其强制优先下载预构建的 dist 压缩包（.zip/.tar.gz），跳过 git clone、checkout 等耗时操作；但需配合镜像源且依赖包本身提供 dist 才生效。
Composer 安装慢，不是网络问题就是配置没对；启用 prefer-dist 能显著提速，但默认不生效，必须显式设置或配合其他策略。
为什么 prefer-dist 能加快安装？
Composer 默认会根据包的 dist（压缩包）和 source（Git 仓库）两种方式拉取代码。prefer-dist 强制优先走 dist：直接下载预构建的 .zip 或 .tar.gz，跳过 git clone、git checkout、子模块解析等耗时操作。尤其在 CI 环境或低带宽机器上，差异非常明显。
注意：prefer-dist 不是万能加速器——如果包没发布 dist（比如只设了 source），它会自动回退到 source 模式，速度不会提升。
-
prefer-dist是全局行为开关，影响所有依赖，不是单个包的配置 - 它只控制「如何获取」，不影响自动加载、脚本执行等后续步骤
- 国内用户需搭配镜像源（如阿里云、腾讯云 Composer 镜像）才真正见效
怎么启用 prefer-dist？三种可靠方式
不能只靠 composer install --prefer-dist 临时加参数——很多 CI 工具或部署脚本会忽略命令行参数，或被 composer.lock 锁死行为。必须从配置源头固化。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局设置（推荐）：
composer config -g prefer-dist true
这样所有项目都默认走 dist - 项目级设置（更可控）：
composer config prefer-dist true
写入当前项目的composer.json的config段 - 环境变量兜底（CI 场景必备）：
COMPOSER_PREFER_DIST=1，比命令行参数优先级高，Docker 或 GitHub Actions 中可直接注入
prefer-dist 和 --no-dev 组合使用效果更明显
开发依赖（require-dev）通常体积大、更新频繁，且多数不参与生产运行。跳过它们 + 强制 dist，能减少 40%～70% 的下载量和解压时间。
- 本地开发用
composer install（保留 dev） - 部署/CI 用
composer install --no-dev --prefer-dist，并确保COMPOSER_PREFER_DIST=1已设置 - 若
composer.lock是用--no-dev生成的，后续install就不会再拉 dev 包，哪怕没加该参数
常见失效原因和排查点
启用了 prefer-dist 却没变快？大概率卡在别处：
- 没换镜像源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/必做 - 包本身没 dist：
composer show vendor/package查看输出里是否有dist字段；没有就只能走 source - 用了
repositories自定义源，且该源返回的包信息缺失dist描述 - PHP zlib 扩展未启用，导致无法解压
.zip，Composer 会静默回退到source，但不报错——检查php -m | grep zlib
最隐蔽的问题：某些私有 Packagist 实现（如 Satis、Private Packagist）默认不生成 dist，需要额外配置 archive 选项并开启 ZIP 支持。
