Composer的 "dry-run" 参数如何用于所有修改性命令_安全预览 "update", "require", "remove" 的执行结果

使用 --dry-run 参数可预览 Composer 命令变更而不实际执行：1. composer update --dry-run 显示将升级、移除或安装的包；2. composer require --dry-run 预览新增依赖及其依赖树；3. composer remove --dry-run 检查删除包时的影响；结合 -v 可查看详细解析过程，确保变更安全。

Composer 的 dry-run 模式可以帮助你在不实际修改项目文件的情况下，预览诸如 update、require、remove 等命令会带来的变更。这在确认依赖更新是否安全、是否会引入破坏性更改时非常有用。

如何使用 --dry-run 参数

在大多数修改项目的 Composer 命令中，添加 --dry-run 参数后，Composer 会模拟执行过程，输出将要进行的操作，但不会：

• 下载或安装任何包
• 修改 vendor/ 目录
• 更新 composer.lock
• 修改 composer.json（仅对 require/remove）

注意：不是所有命令都原生支持 --dry-run，但 update、require、remove 在较新版本的 Composer 中已支持该参数。

各命令的 dry-run 使用示例

1. composer update --dry-run
查看运行更新后会升级哪些包：

composer update --dry-run

登录后复制

输出示例：

Loading composer repositories with package information
Updating dependencies
Lock file operations:
  - Upgrade monolog/monolog (2.3.0 => 2.4.0)
  - Remove symfony/debug (v4.4.0)
  - Install symfony/error-handler (v5.4.0)
Writing lock file
Generating autoload files

登录后复制

以上操作不会真正执行，lock 文件和 vendor 不会被改动。

2. composer require --dry-run
预览添加新依赖的影响：

composer require doctrine/orm --dry-run

登录后复制

你会看到将要安装的包及其依赖树，Composer 也会提示是否存在版本冲突风险，而不会实际写入 composer.json 或安装文件。

标签： php js json composer 为什么