答案:--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-distComposer 会尝试从 dist 镜像下载 laravel/framework 的 zip 包并解压到 vendor 目录。
什么是 --prefer-source
--prefer-source 表示优先从源代码仓库(通常是 Git 仓库)克隆依赖。
这种方式适用于需要查看或修改第三方库代码的场景,其特点有:
- 会完整克隆整个仓库,包含 .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 项目的依赖方式。根据实际需求选择合适策略即可。










