–prefer-source 优先从源码安装，适合开发调试；–prefer-dist 优先下载压缩包，适合生产环境部署。

在使用 Composer 安装依赖时，–prefer-source 和 –prefer-dist 是两种不同的包获取方式，它们决定了 Composer 从哪里以及如何下载和安装依赖包。

–prefer-source：优先从源码安装

使用 –prefer-source 时，Composer 会优先从版本控制仓库（如 Git）克隆源代码来安装依赖。这意味着你得到的是完整的项目源码，包括 .git 目录和其他开发文件。

• 适合需要调试、修改或贡献代码的场景
• 便于直接修改第三方库并测试更改
• 占用更多磁盘空间，因为包含完整历史记录
• 安装速度较慢，尤其是大项目

例如：

composer require monolog/monolog --prefer-source

这会通过 Git 克隆 monolog 的源码到 vendor 目录下。

–prefer-dist：优先从压缩包安装

使用 –prefer-dist 时，Composer 会优先下载预打包的压缩文件（通常是 zip 或 tar.gz），这是大多数生产环境的默认行为。

魔乐社区

天翼云和华为联合打造的ai开发者社区，支持AI模型评测训练、全流程开发应用

102

查看详情

• 安装更快，网络传输数据更小
• 不包含版本控制历史，更节省空间
• 适合生产部署，不需要修改源码的情况
• 无法直接进行本地修改或提交变更

例如：

composer require monolog/monolog --prefer-dist

这会下载一个已经打好包的 monolog 发行版本。

实际应用建议

开发阶段如果想深入理解或修改某个组件，用 –prefer-source 更方便。上线部署时推荐使用默认的 dist 方式以提升效率。

也可以在 composer.json 中为特定包强制指定首选方式：

"config": {     "preferred-install": {         "monolog/*": "source",         "laravel/*": "dist"     } }

基本上就这些。选择哪种方式，取决于你是想“用”这个包，还是想“改”这个包。