prefer-dist优先下载压缩包,安装快、占空间小,适合生产环境;prefer-source通过git克隆源码,含完整历史,便于开发调试,适合本地开发。

在使用 Composer 安装或更新依赖时,"prefer-dist" 和 "prefer-source" 是两种获取包的方式,它们决定了 Composer 从哪里以及如何下载和安装依赖包。
prefer-dist:优先从压缩包安装
当设置为 prefer-dist 时,Composer 会优先从 VCS(如 GitHub)生成的压缩包(如 zip、tar.gz)来安装包。这些压缩包通常由版本控制系统自动生成,对应某个 tag 或 release。
特点:
- 安装速度快,因为只下载打包好的代码,不包含完整的版本历史。
- 占用磁盘空间小,适合生产环境。
- 无法直接修改源码,也不包含 .git 目录,不能进行本地提交。
- 适用于稳定版本(tag)的安装。
prefer-source:优先从源码仓库克隆
当设置为 prefer-source 时,Composer 会优先通过 git clone(或其他 VCS 方式)将整个代码仓库完整拉取到本地。
特点:
- 包含完整的版本历史,有 .git 目录,可以进行开发、切换分支、提交更改。
- 占用空间大,但便于调试和贡献代码。
- 适合开发阶段,尤其是需要修改第三方包或测试 dev 分支时。
- 如果你运行
composer install并希望所有包都以源码形式存在,方便 Xdebug 断点或阅读源码,这很有用。
如何设置?
可以在 composer.json 中全局配置:
{
"config": {
"preferred-install": {
"my/package": "source",
"*": "dist"
}
}
}
或者统一设置:
{
"config": {
"preferred-install": "source"
}
}
也可以在命令行临时指定:
composer install --prefer-source composer install --prefer-dist
实际应用场景
- 生产环境部署通常使用 --prefer-dist,快速、轻量。
- 本地开发调试第三方包时使用 --prefer-source,可进入 vendor 目录修改代码、创建补丁。
- 某些私有包或 dev 分支只能通过 source 安装。
基本上就这些。根据你的使用场景选择合适的方式,能更高效地管理 PHP 依赖。










