如何在 Composer 中使用 --prefer-dist 和 --prefer-source 选项？

新闻中心 NEWS CENTER

2025-12-08

浏览次数：次

--prefer-dist 用于生产环境，下载预构建压缩包，安装快、占空间小；--prefer-source 用于开发调试，克隆完整 Git 仓库，支持修改和提交。

如何在 composer 中使用 --prefer-dist 和 --prefer-source 选项？

在 Composer 中，--prefer-dist 和 --prefer-source 是控制依赖包安装方式的两个关键选项，它们影响的是包的获取来源和本地存储形式，直接关系到安装速度、磁盘占用和后续开发便利性。

这是 Composer 的默认行为，适用于大多数生产环境或普通使用场景。它会优先从包的发布版本（如 GitHub 的 Release ZIP 包、Packagist 提供的压缩包）下载预构建的归档文件。

当你需要修改依赖源码、调试底层逻辑、或贡献补丁时，应使用该选项。它会通过 Git（或其他 VCS）克隆整个代码仓库到 vendor/ 目录下，并保留完整提交历史和分支信息。

支持本地修改和提交：可直接在 vendor/xxx 中改代码、打补丁、切分支
便于调试和跟踪：能用 git blame、git log 查看变更来源
适合开发阶段或维护 fork：例如你正在为某个包提 PR，需基于其 dev-main 分支开发
执行命令：composer install --prefer-source（注意：首次安装后，后续 composer update 默认仍走 dist，除非显式指定）

不必每次输入参数，可在项目根目录的 composer.json 中配置：

标贝悦读AI配音

在线文字转语音软件-专业的配音网站

78 查看详情标贝悦读AI配音

全局设为 prefer-dist："config": { "preferred-install": "dist" }
全局设为 prefer-source："config": { "preferred-install": "source" }
按包类型区分（推荐）："preferred-install": { "*": "dist", "dev-*": "source" } —— 比如让所有 dev 包走 source，稳定版走 dist