运行 composer update --dry-run 可预览依赖更新情况而不实际修改文件,适用于评估升级影响、检查兼容性及团队协作审查,通过指定包名或通配符可精准模拟变更,输出结果清晰展示将升级、安装或移除的包,帮助规避潜在风险。

运行 composer update --dry-run 可以让你在不真正更改项目依赖的情况下预览将要发生的更新操作。这个命令会模拟整个更新流程,显示哪些包会被安装、升级、降级或移除,帮助你评估更新带来的影响。
作用与使用场景
当你不确定更新依赖是否会影响项目稳定性时,--dry-run 是一个安全的检查手段。它不会修改 composer.json、composer.lock 或 vendor 目录中的任何文件,仅输出预计变更。
常见用途包括:
- 查看某个特定包更新后会引入哪些新依赖
- 确认大版本升级是否会破坏现有兼容性
- 团队协作中提前审查依赖变更清单
基本用法示例
执行以下命令进行预览:
composer update --dry-run如果你想只预览某个包的更新情况,可以指定包名:
composer update monolog/monolog --dry-run也可以结合其他选项,比如锁定主版本:
composer update "monolog/*" --dry-run输出内容解读
命令执行后,你会看到类似如下信息:
- Loading composer repositories with package information
- Updating dependencies
- - Upgrading monolog/monolog (1.25.0 => 2.0.0)
- - Installing psr/log (1.1.0)
- - Removing old/package (0.5.0)
这些条目清楚地展示了即将发生的变化,便于你判断是否继续实际更新。
基本上就这些,用 --dry-run 多看一眼,能避免不少线上问题。










