答案：--prefer-dist优先下载压缩包，安装快、占用空间小，适合生产环境；--prefer-source克隆源码，含版本历史，便于调试修改，适合开发。默认优先dist，可通过composer.json配置preferred-install指定策略，按需选择更高效。

在使用 Composer 安装或更新 PHP 依赖包时，可以指定 --prefer-dist 和 --prefer-source 参数来控制依赖的安装方式。这两种方式影响的是包从哪里获取以及如何存储在本地项目中。

什么是 --prefer-dist

--prefer-dist 表示优先从远程的压缩包（如 zip、tar.gz）安装依赖。这些压缩包通常托管在 Packagist 或 CDN 上。

使用该方式的特点包括：

• 安装速度快，因为只下载预打包的发布版本
• 占用磁盘空间小，不包含版本控制历史（如 .git 目录）
• 适合生产环境部署，稳定且高效
• 无法直接修改包源码，不适合开发调试

例如执行：

composer install --prefer-dist

Composer 会尝试从 dist 镜像下载 laravel/framework 的 zip 包并解压到 vendor 目录。

什么是 --prefer-source

--prefer-source 表示优先从源代码仓库（通常是 Git 仓库）克隆依赖。

这种方式适用于需要查看或修改第三方库代码的场景，其特点有：

• 会完整克隆整个仓库，包含 .git 目录和所有提交历史
• 便于调试、打补丁或贡献代码
• 占用更多磁盘空间，安装较慢
• 可以在本地修改后提交更改，方便开发测试

比如运行：

git摸鱼周报自动化

生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。

下载

composer update --prefer-source

如果某个包支持 Git 克隆，Composer 就会通过 git clone 把源码拉下来，而不是下载压缩包。

默认行为与配置文件设置

如果不加任何参数，Composer 会根据内部策略自动选择 source 或 dist，通常优先 dist 以提升性能。

你也可以在 composer.json 中全局设定偏好：

{ "config": { "preferred-install": { "my/package": "source", "*": "dist" } } }

上面配置表示：所有包走 dist 安装，但 my/package 强制用 source 方式。

另外，preferred-install 还支持字符串形式简化设置：

"preferred-install": "source"

这会让所有包默认使用源码安装。

实际应用场景建议

• 日常开发中若不需要改第三方库代码，用 --prefer-dist 更快更省资源
• 当你需要为某个开源项目调试或提 PR，可用 --prefer-source 拉下源码方便修改
• CI/CD 构建流程推荐使用 --prefer-dist 提高构建速度
• 团队协作开发内部私有包时，常设 preferred-install 为 source，便于实时同步变更

基本上就这些。理解 dist 和 source 的区别，能帮助你更高效地管理 PHP 项目的依赖方式。根据实际需求选择合适策略即可。