composer不支持自动识别子目录的composer.json，必须在主项目中通过repositories配置path类型仓库并显式require子包，且子包name须与require一致、autoload需正确声明。
多个 composer.json 怎么让主项目识别它们
Composer 本身不支持“自动扫描子目录下的 composer.json”，必须显式告诉它哪些本地路径是可安装的包。核心机制是 repositories + path 类型配置，否则 composer install 完全无视 module-a/composer.json 这类文件。
- 主项目的
composer.json中必须声明repositories数组，每个项指定"type": "path"和对应目录（如"url": "module-a"） - 子模块的
composer.json里name字段值（如"my-project/module-a"）必须和主项目require中写的包名完全一致 -
url是相对于主项目根目录的路径，不能用../跨出项目边界，否则composer validate会报错 - 运行
composer install后，Composer 会把module-a/整个目录软链接或复制进vendor/my-project/module-a，不是只读取其composer.json
多模块依赖冲突时为什么 composer install 会失败
冲突不是因为“多个 composer.json 并存”，而是 Composer 在解析整个依赖图时发现无法满足所有版本约束。比如 module-a 要 monolog/monolog:^2.0，module-b 要 monolog/monolog:^1.25，而主项目又没做任何协调，Composer 就找不到一个同时满足两者的版本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误现象通常是
[ComposerDependencyResolverSolverProblemsException]后跟一堆无法满足的约束条件 - 最直接的缓解方式是在主项目
composer.json的conflict段排除掉已知不兼容的版本范围，例如"monolog/monolog": "=3.0" - 更可持续的做法是统一升级 module-b，让它也兼容
^2.0；强制降级不是解法，容易埋下运行时异常 -
composer why-not monolog/monolog:2.10.0可快速定位是哪个模块在阻止该版本安装
怎么安全地批量增删多个本地模块依赖
别用 composer require my-project/module-a my-project/module-b 这种写法——composer require 不接受空格分隔的多个包名，第二项会被当成独立包去 Packagist 查，大概率报 Could not find package。
- 加
--no-update分批写入配置：先composer require my-project/module-a --no-update，再composer require my-project/module-b --no-update，最后统一composer update - 卸载必须用
composer remove（Composer 2.2+），支持空格分隔：composer remove my-project/module-a my-project/module-b，它会同步清理vendor/、autoload 映射和composer.lock - 手改
composer.json后直接composer install很危险：如果某个模块路径不存在或name对不上，Composer 可能静默跳过，导致 vendor 里缺东西但不报错 - 每次修改后跑
composer validate，它会检查repositories路径是否存在、name是否合法、是否有循环依赖等
为什么 vendor/autoload.php 加载不到本地模块里的类
不是自动加载失效，而是 Composer 根本没把模块装进去——常见于 repositories 配置有误，或子模块 composer.json 缺少 autoload 声明。
- 确认
vendor/my-project/module-a/目录真实存在，且内容完整（含src/、composer.json等） - 子模块自己的
composer.json必须包含autoload段，比如"psr-4": {"MyProject\ModuleA\": "src/"}，否则主项目require_once 'vendor/autoload.php'不会注册它的命名空间 - 修改子模块的 autoload 配置后，必须在主项目中运行
composer dump-autoload，否则旧映射仍生效 - 如果子模块用了
classmap，确保composer dump-autoload -o重新生成优化版，否则新增类可能被忽略
name 是否全局唯一、repositories 路径是否稳定、autoload 规则是否与实际目录结构对齐。这些细节一旦错位，错误表现往往滞后且模糊。
