大型项目不应将 composer.json 放在根目录，而应为每个业务模块（如 user-service、order-module）配置独立的 composer.json 和 path 类型仓库，以避免依赖冲突、版本锁定困难及 autoload 命名空间覆盖等问题。
为什么 composer.json 不该放在项目根目录
大型项目常被拆成多个业务模块（如 user-service、order-module），如果所有模块共用一个根级 composer.json，会导致依赖冲突、版本锁定困难、CI 构建粒度粗。真实场景中，你改了 user-service 的 monolog 版本，结果 order-module 的日志行为意外变更——这不是偶然，是共享 vendor 目录的必然结果。
子目录配置方案的核心，就是让每个模块拥有独立的 composer.json 和隔离的依赖空间。这不等于“每个模块都 composer install 一遍”，而是通过路径映射与自动加载协同实现。
如何用 path 仓库类型本地链接模块
在主项目（或统一管理仓库）的根 composer.json 中，把各模块声明为 path 类型仓库，才能让 Composer 认出它们是可安装的包，而非普通文件夹：
{
"repositories": [
{
"type": "path",
"url": "./modules/user-service"
},
{
"type": "path",
"url": "./modules/order-module"
}
],
"require": {
"myapp/user-service": "*",
"myapp/order-module": "*"
}
}
关键点：
-
url必须是相对于根composer.json的路径，不能用../跨出项目边界 - 每个模块子目录里必须有合法的
composer.json，且含name字段（如"name": "myapp/user-service"），否则 Composer 找不到包 -
"*"会匹配模块目录下的dev-main或dev-develop分支，不是任意提交；如需固定到某次提交，得用"dev-main#abc123"
模块内 autoload 怎么配才不和主项目冲突
模块自己的 composer.json 中，autoload 配置决定其类能否被主项目正确加载。常见错误是直接写 "psr-4": {"App": "src/"} —— 这会让所有模块都注册 App 命名空间，最终只有最后一个生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法是为每个模块分配唯一命名空间前缀：
{
"name": "myapp/user-service",
"autoload": {
"psr-4": {
"MyApp\UserService\": "src/"
}
}
}
同时确保主项目的 composer.json 没有覆盖式 autoload 声明。Composer 会自动合并所有已安装包的 autoload 配置，不需要手动 dump-autoload —— 除非你改了某个模块的 autoload 后没重新 composer install。
CI/CD 中如何避免重复下载和构建失败
子目录方案下，composer install 默认仍会拉取全部远程依赖（哪怕模块是本地 path），但不会重装本地模块本身。问题常出在 CI 环境缺少缓存或权限：
- Git 子模块未初始化？
git submodule update --init必须在composer install前执行 - CI 工作目录权限导致
vendor/写入失败？别用root用户跑 composer，改用项目指定用户 - 想跳过某些 dev-only 包加速构建？加
--no-dev，但注意：如果模块的测试工具（如phpunit）被列为require-dev，而你又在模块内运行测试，就得保留它
最易忽略的一点：模块间存在循环 require（A require B，B require A），Composer 不报错但会静默忽略后声明的依赖，最终 class not found。用 composer depends myapp/order-module 可查谁依赖了它，辅助定位。
