答案：多模块composer版本冲突根源在于各模块composer.json版本约束互斥或共享依赖被不兼容锁定，而非模块数量多；应统一收口依赖至主项目、禁用canonical、用composer why-not精准定位阻塞点。
多模块开发中出现的 Composer 版本冲突，根本不是“模块太多”导致的，而是各模块的 composer.json 里写的版本约束互相打架，或者共享依赖被不同模块以不兼容方式锁定。删 vendor 或强制 --ignore-platform-reqs 只会让问题延迟爆发。
为什么多模块项目更容易爆冲突
模块之间通常通过 path 仓库或私有 Packagist 源引入，但每个模块自带独立的 composer.json，容易各自声明不一致的依赖版本。比如：
- 模块 A 写
"monolog/monolog": "^2.8" - 模块 B 写
"monolog/monolog": "3.0.0" - 主项目又 require 了模块 A 和 B —— Composer 就找不到交集
更隐蔽的是 conflict 规则、replace 声明、或 require-dev 中的测试工具（如 phpunit/phpunit）间接锁死 sebastian/exporter，再卡住整个 symfony/console 链。
用 composer why-not 定位真实阻塞点
报错里出现 don’t install monolog/monolog:3.0.0，别猜，直接查：
composer why-not monolog/monolog:3.0.0
输出从下往上读：
- 最后一行是你主项目的
composer.json根声明 - 往上每一行带
(required by)的，就是某模块或其子依赖施加的互斥约束 - 如果输出为空，先加
--dev：很多冲突来自require-dev，默认不查
注意：必须写完整版本号，monolog/monolog:^3 可能匹配不到元数据，得用 monolog/monolog:3.0.0。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
模块间依赖要统一收口，别各自为政
多模块不是放任每个模块自己管依赖，而是把共享依赖提到主项目 composer.json 中显性声明：
- 删掉各模块里的
"monolog/monolog"、"psr/log"等通用包，只留业务逻辑相关依赖 - 主项目中写死关键包版本，例如：
"monolog/monolog": "3.0.0"，而不是"^3.0" - 所有模块改用
"monolog/monolog": "*"或干脆不声明，靠主项目提供 autoload 和版本
这样 Composer 解析时只有一个权威来源，不会在模块 A 和模块 B 之间来回摇摆。
path 仓库配置必须设 "canonical": false
如果你用 repositories.type: path 引入本地模块，不加 "canonical": false，Composer 会认为“这个路径仓库已覆盖所有同名包”，直接跳过 Packagist 查找 —— 即使该路径下没提供 guzzlehttp/guzzle，它也不会去官方源找，而是报错或装错版本。
正确写法：
{
"repositories": [
{
"type": "path",
"url": "./modules/*",
"options": {
"symlink": true
},
"canonical": false
}
]
}
验证是否生效：运行 composer show guzzlehttp/guzzle，看 source 字段是否指向你期望的源（路径 or packagist.org）。
真正难处理的不是冲突本身，而是多个模块共用同一组底层依赖（比如 symfony/event-dispatcher）时，某个模块悄悄用了 v6.4 新增的 Event::isPropagationStopped()，而另一个模块还在 v5.x 上跑 —— 这种不兼容不会在 install 阶段报错，要等运行时才炸。所以模块间 API 兼容性得靠文档约定 + CI 中固定 PHP 和依赖版本来兜底。
