–dry-run 用于模拟执行 composer install,预览依赖安装、更新或删除操作而不实际修改文件,帮助验证 composer.json 变更影响、确认兼容性、排查问题,适用于添加包前检查、切换分支或 CI/CD 中的安全审查。
composer install –dry-run 的作用是模拟执行 composer install
命令,但不会真正修改项目中的文件或安装任何依赖。它能让你预览 Composer 在实际运行时会做哪些操作。
查看将要安装的依赖
使用 --dry-run
时,Composer 会输出它打算安装、更新或删除的包列表,帮助你提前了解变更内容。
例如:
- 某个包会被安装
- 某个包版本会发生变化
- 某些包因为不再需要而被移除
验证 composer.json 变更的影响
当你修改了 composer.json
文件后,可以先用 --dry-run
检查这些更改会导致什么结果,避免意外升级或降级关键依赖。
适用场景包括:
- 添加新包前确认兼容性
- 切换分支后预判依赖变化
- CI/CD 流程中做安全检查
调试和排查问题
如果依赖解析出现问题,--dry-run
能配合其他选项(如 -v
输出详细信息)帮助你理解 Composer 的决策过程,比如为什么某个包没被更新。
基本上就这些。这个参数不改变任何东西,只用来“看一眼”会发生什么,适合在正式操作前做一次安全预演。