composer update --dry-run 是唯一能快速验证依赖兼容性的命令，它完整执行sat求解器推理、校验版本约束与冲突，但不写入vendor/或修改composer.lock；composer validate和check-platform-reqs均无法检测包间依赖一致性问题。
composer install 前如何快速验证依赖兼容性？
直接运行 composer install 是最准的，但耗时且可能中途失败；真正想“预检”的话，composer update --dry-run 是唯一靠谱的一条命令——它会完整走完依赖解析、版本约束校验、冲突检测流程，但不写入 vendor/ 或修改 composer.lock。
为什么不用 composer validate 或 composer check-platform-reqs？
composer validate 只检查 composer.json 格式和基础字段，完全不触碰依赖树；composer check-platform-reqs 仅比对当前 PHP 扩展和 platform 配置，不涉及包间冲突。这两者都漏掉最关键的“能否解出一致版本”问题。
执行 composer update --dry-run 的注意事项
这条命令实际行为和 composer update 几乎一致，只是跳过安装步骤。需注意：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 它默认基于
composer.json重新计算依赖，若项目已有composer.lock，建议加--with-dependencies确保包含已锁版本的子依赖校验 - 如果 CI 或脚本中使用，可追加
-q（quiet）减少输出，失败时返回非 0 状态码，适合做前置判断 - 某些私有仓库或需要认证的源，
--dry-run同样会尝试访问，网络不通或 token 过期也会报错，这不是误报 - PHP 版本、扩展要求（如 ext-gd）、平台配置（
platform）全部参与计算，结果可信度高
常见失败现象及对应原因
运行 composer update --dry-run 报错时，典型提示包括：
-
Root composer.json requires ... but it is not satisfiable：某包版本约束与其它依赖冲突，比如 A 要求 ^2.0，B 要求 ^3.0 -
Your requirements could not be resolved to an installable set of packages：更笼统的冲突提示，通常需看上面几行具体哪个包卡住 -
Package ... has a PHP requirement incompatible with your PHP version：PHP 小版本不匹配，比如php: ^8.1但本地是 8.0.30 -
Could not find package ...：包名拼错、仓库不可达、或 require-dev 中引用了被移除的包
这些错误在真正跑 composer install 时一样会出现，提前捕获能省下大量等待时间。
真正麻烦的是那些“看似通过但运行时报错”的情况——比如扩展存在但函数被禁用（disable_functions=exec）、环境变量缺失导致服务启动失败，这些 --dry-run 无法覆盖。依赖解析只是第一关。
