prefer-dist 优先下载预打包的压缩文件，安装快、占用小，适合生产环境；prefer-source 优先克隆源码仓库，便于调试和贡献开源，适用于开发场景。默认采用 prefer-dist，可通过全局、项目或按包配置灵活设置策略，提升开发与部署效率。
在使用 Composer 管理 PHP 项目依赖时，prefer-source 和 prefer-dist 是两个影响包安装方式的重要配置项。它们决定了 Composer 在下载依赖包时是优先从源码（如 Git 仓库）还是从预打包的压缩文件（dist 包）进行安装。
什么是 prefer-dist？
当设置为 prefer-dist 时，Composer 会优先选择从远程服务器下载已打包好的压缩文件（通常是 zip 或 tar.gz 格式）。这些文件由 Packagist 预先构建并缓存，安装速度快，适合生产环境。
这种模式的优点包括：
- 安装速度更快，无需克隆整个代码仓库
- 占用本地磁盘空间更小
- 不需要安装版本控制工具（如 Git）
- 更适合部署和 CI/CD 流程
默认情况下，Composer 就采用 prefer-dist 策略，除非另有配置。
什么是 prefer-source？
启用 prefer-source 后，Composer 会优先通过版本控制系统（如 Git）克隆包的完整源码仓库。这意味着你获取的是完整的项目历史记录和开发分支。
这个模式适用于：
- 需要调试第三方库代码
- 打算修改某个依赖并提交 Pull Request
- 希望在本地直接运行测试用例
- 开发环境中需要查看或切换不同分支
使用 source 方式安装后，你可以进入 vendor 中的包目录执行 git 命令，比如切换分支、拉取最新提交等。
如何配置 prefer-source 和 prefer-dist？
这两个选项可以在多个层级进行设置：
1. 全局配置（影响所有项目）
composer config -g preferred-install dist或
composer config -g preferred-install source
2. 项目级配置（仅对当前项目生效）
composer config preferred-install dist3. 更精细的控制：按包指定
你还可以针对特定包设置策略，例如只对某个开发中的库使用 source：
composer config preferred-install "vendor/package" source或者在 composer.json 中直接写明：
"config": {
"preferred-install": {
"mycompany/*": "source",
"*": "dist"
}
}
上述配置表示：所有 mycompany 下的包使用 source 安装，其余使用 dist。
实际应用场景对比
生产环境部署：推荐使用 prefer-dist，因为部署追求快速、稳定、轻量，不需要源码历史。
本地开发调试：若需深入排查某个组件的问题，可临时设为 prefer-source，便于 var_dump、xdebug 断点或临时修改。
贡献开源项目：当你准备给某个包提 PR，建议使用 prefer-source，方便提交更改。
基本上就这些。理解 prefer-source 和 prefer-dist 的区别，能让你更灵活地管理依赖，提升开发与部署效率。合理配置，既能保证上线速度，也能支持深度调试。
