使用 --dry-run 参数可预览 Composer 命令操作而不实际修改,例如执行 composer require monolog/monolog:2.0 --dry-run 将显示拟安装的包及版本变化,适用于 install、remove、update 等命令,帮助在生产环境或团队协作中避免误操作,确保依赖变更安全可控。

使用 composer --dry-run 参数可以模拟执行命令的操作,但不会真正修改项目文件或安装包。它主要用于预览 Composer 命令(如更新、安装、移除依赖)将要执行的动作,帮助你判断是否会产生预期效果,而不会对当前环境造成实际影响。
查看变更前的预演
当你运行类似 composer require vendor/package 或 composer update 时,加上 --dry-run 可以看到 Composer 会做哪些事情:
- 列出将要安装、更新或卸载的包
- 显示版本变化情况
- 检查依赖冲突的可能性
例如:
composer require monolog/monolog:2.0 --dry-run这条命令不会真的添加包,但会告诉你如果执行了会发生什么。
避免误操作风险
在生产环境或关键分支上修改依赖时容易出错。--dry-run 提供了一种安全方式来验证命令行为,尤其适用于:
- 团队协作中确认变更内容
- CI/CD 脚本调试阶段
- 学习 Composer 行为的新手用户
适用场景举例
常见可配合 --dry-run 使用的命令包括:
-
composer install --dry-run:查看是否会有包被安装或更新 -
composer remove some/package --dry-run:确认删除某个包是否会破坏其他依赖 -
composer update --dry-run:预览整个更新过程的影响范围
基本上就这些。它不改变任何文件,也不下载代码,只是“说一遍你要做的事”。适合用来确认操作无误后再真正执行。










