composer require --prefer-source 和 --prefer-dist的区别

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

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

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

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

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

例如：

AutoGLM沉思

智谱AI推出的具备深度研究和自主执行能力的AI智能体

239 查看详情

composer require monolog/monolog --prefer-source

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

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

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

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

例如：

composer require monolog/monolog --prefer-dist

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

实际应用建议

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

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

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

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

以上就是composer require --prefer-source 和 --prefer-dist的区别的详细内容，更多请关注其它相关文章！