composer依赖不能只靠require堆砌，因为混用开发、运行、构建、测试依赖会导致ci慢、部署臃肿、升级误删、协作混乱；需用require-dev/require粗分，再结合config.platform约束环境、replace占位抽象、create-project+scripts固化模块边界、why-not定位冲突、严控^/~语义差异。
Composer依赖为什么不能只靠require堆砌？
因为composer.json里混着开发用的、运行时用的、构建用的、甚至测试专用的包，不分类会导致：CI 构建慢（比如phpunit被装进生产镜像）、部署体积膨胀、升级时误删关键工具、团队协作时搞不清“这个包到底谁在用”。Composer 本身不强制分类，但require-dev和require只是最粗粒度的分法，远不够用。
用config.platform和replace隔离环境差异
有些依赖只在特定 PHP 版本或扩展下才有意义（比如ext-redis在 Docker 和本地开发可能启用状态不同），硬编码到require里会引发安装失败。这时候不该靠文档说明，而要用 Composer 原生机制约束：
-
config.platform声明目标环境能力，比如"platform": {"php": "8.2.10", "ext-redis": "5.3.7"}，让composer install按此解析依赖，避免本地装了ext-igbinary就偷偷引入兼容包 -
replace用于模块化占位，比如你把日志抽象成myapp/logger-contract，再用"replace": {"myapp/logger-contract": "self.version"}，其他模块就能require这个虚拟包而不绑定具体实现 - 注意：
replace不会自动加载代码，必须配合autoload或autoload-dev显式声明 PSR-4 映射
用composer create-project模板+scripts固化模块边界
当项目大到需要拆出payment-module、notification-module时，别指望靠文件夹命名自觉遵守边界——得用 Composer 脚本强制执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 每个模块独立
composer.json，type设为library，并用autoload限定仅暴露接口和 DTO - 主项目
composer.json中用repositories指向各模块路径（如{"type": "path", "url": "../modules/payment-module"}），避免提前发布到 Packagist - 在
scripts里加"check-module-deps": "composer validate --no-check-all && composer show | grep -E '^(payment|notification)-module'"，CI 中跑这个脚本确保没漏掉模块依赖
依赖冲突时优先看why-not而非update
执行composer update卡住或报错，很多人直接加--with-all-dependencies硬推，结果破坏稳定性。更稳妥的做法是定位真实冲突点：
- 用
composer why-not vendor/package:version查哪个已装包在阻止升级，比如输出myapp/core 2.1.0 requires php ^8.1 -> your php version (8.0.30) does not satisfy that requirement - 若发现是
require-dev里的某个工具（如phpstan/phpstan）锁死了 PHP 版本，就把它挪到单独的composer.json（如dev-tools/composer.json），主项目不再承担它的约束 - 警惕
^和~的语义差异：^2.0允许升到2.9.9，~2.0只允许2.0.x，模块间版本策略不一致时，冲突往往藏在这里
模块化不是给composer.json加更多字段，而是用平台配置、替换规则、脚本校验和精准的版本约束，把“谁能在哪用什么”变成机器可验证的事实。最容易被忽略的是config.platform——它不改变代码行为，但决定了整个依赖图的生成逻辑，一旦漏配，后面所有分类都可能失效。
