--dry-run 参数用于模拟 Composer 操作而不修改文件，可预览包的安装、更新或降级情况，识别版本变更与潜在冲突，验证 composer.json 修改影响，辅助调试依赖问题，确保操作安全可控。

Composer 的 --dry-run 参数主要用于模拟安装或更新操作，而不真正修改项目文件。它能让你预览 Composer 将要执行的动作，帮助你判断变更的影响，避免误操作。

查看将要安装或更新的包

当你运行 composer update --dry-run 或 composer require vendor/package --dry-run 时，Composer 会输出它打算进行的操作，比如：

• 哪些包会被安装、升级或降级
• 版本号的具体变化
• 是否涉及重大版本变更（BC break 风险）

这在生产环境或团队协作中特别有用，提前确认依赖变更是否合理。

验证 composer.json 修改的影响

如果你刚修改了 composer.json 中的版本约束，可以加上 --dry-run 来测试这些更改会导致什么结果，而不会实际写入 vendor/ 目录或更新 composer.lock。

例如：

可以看到“如果不加 --dry-run，会装哪些东西”，便于评估风险。

辅助调试依赖冲突

当遇到依赖无法解析的问题时，使用 --dry-run 配合其他参数可以帮助你理解 Composer 是如何尝试解决依赖的。虽然它不会解决问题本身，但结合输出信息，更容易定位是哪个包导致了冲突。

基本上就这些 —— --dry-run 不会改变你的项目状态，但它提供了一个安全的“预演”方式，让你更自信地执行真正的操作。