大型项目不能共用一个composer.json，因模块共享vendor会导致Class not found或行为突变；必须为每个模块配独立composer.json+path仓库，确保name全限定、autoload前缀唯一、vendor彻底隔离。
大型项目不能把所有模块塞进一个 composer.json，否则改一个模块的依赖，其他模块就可能出 Class not found 或日志行为突变——这不是运气差，是共享 vendor/ 的必然结果。
为什么根目录放一个 composer.json 行不通
真实场景里，user-service 升了 monolog 2.10，order-module 却跟着加载了新版的 MonologHandlerStreamHandler，而它内部用的还是旧版接口。问题不在代码，而在两个模块共用同一份 autoload_static.php 和同一套 vendor/ 路径映射。
Composer 没有“模块级依赖隔离”机制，默认向上查找 composer.json，一旦子目录没拦住，就会往主项目 vendor/ 里装包。这不是配置疏漏，是设计边界。
-
require写错命名空间前缀，多个模块注册同名 PSR-4 前缀（如都写"App": "src/"），最后只有最后一个生效 -
composer install在子目录执行时，若没加--no-autoloader --no-scripts，会静默污染主项目vendor/ -
composer.lock文件体积暴涨（超 10MB），解析慢、CI 构建卡在 autoload dump 阶段
每个模块配独立 composer.json + path 仓库
核心不是“多装几遍 Composer”，而是让每个模块成为可被引用的独立包：有自己 name、自己 autoload、自己 vendor-dir，再通过主项目的 repositories 把它们“接入”。
主项目根目录 composer.json 中声明：
{
"repositories": [
{
"type": "path",
"url": "./modules/user-service"
},
{
"type": "path",
"url": "./modules/order-module"
}
],
"require": {
"myapp/user-service": "*",
"myapp/order-module": "*"
}
}
关键约束：
-
url必须是相对路径，不能含../（跨出主项目边界会被拒绝） - 子模块目录下必须有合法
composer.json，且含"name": "myapp/user-service"字段，否则报Could not find package -
"*"匹配的是子模块的dev-main或dev-develop分支，不是任意 commit；要锁定提交用"dev-main#abc123"
子模块 autoload 怎么配才不冲突
错误做法：所有模块都写 "psr-4": {"App": "src/"} —— 这等于让 5 个模块抢注册同一个命名空间，最终只留下最后一个。
正确做法：每个模块用唯一前缀，例如：
{
"name": "myapp/user-service",
"autoload": {
"psr-4": {
"MyApp\UserService\": "src/"
}
}
}
同时确保主项目 composer.json 的 "autoload" 和 "autoload-dev" 里**不包含**子模块源码路径（如 "modules/user-service/src"），否则 dump-autoload 会把它扫进主项目映射，造成重复加载或覆盖。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
子模块内执行安装时，必须加：
composer install --no-autoloader --no-scripts
原因：
-
--no-autoloader：跳过生成vendor/autoload.php，避免它尝试注册主项目的 autoload 配置 -
--no-scripts：防止 post-install-cmd 脚本误操作主项目缓存或配置文件
后续需手动在子模块中 require 'vendor/autoload.php'，或由主项目统一 require（前提是 autoload 命名空间不重叠）。
CI 和 Git 处理容易被忽略的细节
子模块的 vendor/ 目录必须被 Git 忽略，且忽略规则要写在子模块自己的 .gitignore 里，不能只靠主项目根目录的 .gitignore —— 否则 git subtree push 会把整个 vendor/ 推到上游仓库。
子模块根目录下放一个 .gitignore，内容仅一行：
/vendor
CI 流程中，在 subtree push 前加清理步骤：
git clean -xffd modules/user-service/vendor
另外，composer.lock 文件过大时，定期运行：
composer update --lock
它能压缩 JSON、合并冗余字段，实测可将 12MB 的 lock 文件减到 6MB 以内，大幅降低 install 解析耗时。
真正麻烦的从来不是怎么写配置，而是每个子模块的 name 是否全限定、autoload 前缀是否全局唯一、vendor/ 是否被彻底隔离——这三个点漏掉任何一个，都会在某次 composer update 后突然崩掉 autoload 映射。
