composer "prefer-dist" 和 "prefer-source" 选项有什么作用？

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

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

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

当设置为 prefer-dist 时，Composer 会优先从 VCS（如 GitHub）生成的压缩包（如 zip、tar.gz）来安装包。这些压缩包通常由版本控制系统自动生成，对应某个 tag 或 release。

特点：

WordAi

WordAI是一个AI驱动的内容重写平台

53

查看详情

• 安装速度快，因为只下载打包好的代码，不包含完整的版本历史。
• 占用磁盘空间小，适合生产环境。
• 无法直接修改源码，也不包含 .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 依赖。

以上就是composer "prefer-dist" 和 "prefer-source" 选项有什么作用？的详细内容，更多请关注php中文网其它相关文章！