composer的--prefer-dist和--prefer-source选项_Composer Prefer-Dist与Prefer-Source选项说明

--prefer-dist优先下载压缩包，安装快且省空间，适合生产；--prefer-source则克隆源码，含版本信息，便于开发调试；默认根据上下文选择，可通过config配置全局偏好。

在使用 Composer 安装或更新 PHP 依赖包时，--prefer-dist 和 --prefer-source 是两个控制依赖包安装方式的重要选项。它们决定了 Composer 从哪里获取并如何安装这些包。

什么是 --prefer-dist

启用 --prefer-dist 时，Composer 会优先从远程的压缩包（如 zip、tar.gz）安装依赖。这些压缩包通常托管在 Packagist 或 CDN 上，下载速度快，适合生产环境。

这种安装方式的优点包括：

• 安装速度快，因为只下载编译好的代码包
• 节省磁盘空间，不包含版本控制历史（如 .git 目录）
• 适合部署到线上服务器

例如执行：

会尽可能使用 dist 包来安装所有依赖。

什么是 --prefer-source

使用 --prefer-source 时，Composer 会优先通过版本控制系统（通常是 Git）克隆源码来安装依赖。这意味着每个包都会包含完整的仓库信息，比如 .git 文件夹。

这种方式更适合开发和调试场景，优势有：

协和·太初

国内首个针对罕见病领域的AI大模型

38

查看详情

• 方便查看和修改第三方库的源码
• 可以直接提交更改或切换分支
• 便于贡献补丁或进行本地测试

运行如下命令：

会让 Composer 克隆每个包的源码而不是下载压缩包。

默认行为与配置

如果没有指定偏好，Composer 会根据上下文自动选择。例如，在运行 composer install 时，默认倾向于使用 dist；而在开发中执行 composer update，可能更灵活地选择源码方式。

你也可以在 composer.json 中设置全局偏好：

上面的配置表示：所有包默认用 dist 安装，但 my/package 强制使用 source 方式。

基本上就这些。合理使用 --prefer-dist 和 --prefer-source 能提升开发效率或部署性能，按需选择即可。

以上就是composer的--prefer-dist和--prefer-source选项_Composer Prefer-Dist与Prefer-Source选项说明的详细内容，更多请关注php中文网其它相关文章！