--dry-run 是 Composer 的安全预演命令，用于提前识别依赖冲突、版本不兼容、扩展缺失等风险，必须在拉分支、CI检查、PR评审等关键场景强制执行。

--dry-run 不会装任何包，也不会改任何文件，但它能告诉你“如果真执行，Composer 会干啥”——这是你上线前、合代码前、加依赖前最该跑的一条命令。

什么时候必须用 composer install --dry-run？

不是“可选”，而是“不跑就容易翻车”的场景：

• 刚拉完新分支，composer.json 或 composer.lock 有变动，想确认会不会意外升级 symfony/console 到 v7（而你的 PHP 还是 8.1）
• CI/CD 流水线里，想在 composer install 前加一道检查：如果解析出要装 ext-gd 但当前环境没启用，就直接失败
• 团队协作中收到 PR 修改了 require-dev，你不想本地 install 后才发现 phpunit 把 sebastian/environment 升级到了不兼容版本

composer require --dev --dry-run 的真实价值

它不只是“看看要装啥”，而是帮你拦截开发依赖引发的隐性破坏：

• 运行 composer require --dev phpunit/phpunit --dry-run 时，输出里如果出现 will update doctrine/instantiator from 1.5.0 to 2.0.0，就得立刻查文档——v2 是 PHP 8.1+ only，而你项目还跑在 8.0 上
• 如果看到 will remove myproject/utils，说明新包和你已有的工具类存在自动加载冲突或命名空间重叠，不是版本问题，是结构问题
• 它不会触发 post-autoload-dump 脚本，所以即使预览时看到“会生成新的 autoload 文件”，也代表真实安装后可能因脚本失败而中断

composer update --dry-run 为什么比 composer show --outdated 更关键？

show --outdated 只告诉你“哪些包有新版”，而 update --dry-run 告诉你“更新后整个依赖树会变成什么样”：

• 它会模拟锁文件重写过程，显示 composer.lock 中哪些包的 content-hash、platform 或 dist.reference 会被修改
• 输出中若出现 downgrading myvendor/package (dev-main → v3.2.1)，说明约束冲突导致 Composer 回退版本——这往往意味着你写的 ^4.0 和某个间接依赖的 ~3.0 碰上了，不干预就会丢功能
• 加 -v 参数（即 composer update --dry-run -v）能看到解析器决策日志，比如：Trying monolog/monolog:3.0.0 -> satisfiable by monolog/monolog[3.0.0]，这对排查“为啥没装上我要的版本”极其有用

容易被忽略的细节和坑

很多人以为 --dry-run 就是“安全模式”，其实它有边界：

• 它不校验实际网络可达性——预览成功不代表 packagist.org 没被墙，也不代表私有仓库 token 有效
• 它跳过所有 scripts 执行，所以不会触发 post-install-cmd 里的数据库迁移检查，也不会运行 phpstan 静态分析
• 如果你用了 path 类型仓库（如本地开发包），--dry-run 仍会尝试读取其 composer.json，但不会验证路径是否存在——路径错，预览照样过，真装时才报错
• composer install --dry-run 默认基于现有 composer.lock，而 composer update --dry-run 忽略 lock 文件重新解析——别混用场景

真正起作用的从来不是“知道有这个参数”，而是把它塞进你的日常节奏：每次改完 composer.json，先 --dry-run；每次准备部署，CI 里加一行 composer install --dry-run 并设为失败退出码非零；每次 Review 依赖相关 PR，第一眼就看 --dry-run 输出有没有降级或平台变更。

# console  # 很多人  # 什么时候  # 也不  # 我要  # 如果你  # 就会  # 不兼容  # 里加  # 它不  # 告诉你  # 数据库  # php  # Token  # require  # 命名空间  # symfony  # 为什么  # ai  # 工具  # composer  # json  # js 

相关文章： DeepSeek写简历怎么用_DeepSeek写简历使用方法详细指南【教程】  中国第一、全球第四！长鑫科技终于要上市了：TOP5客户首次披露  动态创建可拖拽组件并绑定自定义属性的 Angular 实战教程  ChatGPT写论文大纲教程 辅助学术构思与资料检索操作方法  漫蛙2026永久入口_manwa漫画最新防封地址发布  windows 10专注助手怎么关闭_windows 10禁用通知提醒功能方法  Python日志系统项目教程_日志收集分析与可视化实例  Windows10如何查看蓝屏日志_Win10使用事件查看器分析Dump文件  Python函数缓存失效_场景分析解析【指导】  html5怎么输入空格_HTML5用 或CSS white-space保留输入空格【输入】  80 级制霸攻略：战力进阶与战术全面解析  Win10怎样安装PPT模板_Win10安装PPT模板教程【步骤】  Boss直聘怎么查看谁看过我 Boss直聘查看谁看过我方法【教程】  HTML5article标签适合哪些内容_独立内容块使用规则【解答】  夸克浏览器地址栏搜索不显示怎么办 夸克浏览器搜索栏恢复方法  PPT如何制作动态连线演示动画_PPT逻辑关联设计教程  讯飞星火能否一键生成思维导图_讯飞星火导图生成与结构优化【方法】  容声三款嵌入式冰箱实测：颜值与储鲜双在线的厨房美学担当  Edge浏览器如何截图和滚动截图_微软Edge网页捕获功能使用教程【技巧】  Win11怎么关闭自动维护 Win11禁用系统自动维护功能【优化】  为什么本地php环境访问慢_php本地服务器性能优化方法【说明】  荣耀Power2搭载旗舰同款鸿燕六翼天线 超越友商旗舰  Java依赖倒置原则如何应用_OOP架构设计逻辑讲解  千问如何让提示词更逻辑化_千问逻辑化提示词编写方法【步骤】  html5canvas怎么画渐变背景_createLinearGradient用法详解【汇总】  Win11怎么设置默认视频播放器_Windows 11关联媒体文件打开方式【步骤】  米侠浏览器网页背景异常怎么办 米侠显示修复  如何在 React 中使用 AG Grid 实现行列转置（Transpose）  css 悬停时元素没有动画效果怎么办_通过 hover 触发 animation 执行  css line height 怎么设置更合理_文本垂直间距优化方法 

相关栏目： 【 行业资讯17850 】 【 软件资源51899 】 【 网站技术89748 】 【 百度推广44206 】 【 网络营销84187 】 【 运营推广93002 】 【 AI优化91086 】 【 网络优化117696 】 【 网址导航107142 】