本地path仓库是多模块协同开发的唯一可行路径：必须将repositories配置写在主项目composer.json中，url为相对路径，本地模块需有合法composer.json且name与require严格一致，并已git init提交；require版本用"*"即可匹配，启用symlink需在repositories中显式声明options。
本地 path 仓库是多模块协同开发的唯一可行路径
Composer 本身不支持“一个项目多个 composer.json 自动合并”，所有试图在子目录放独立 composer.json 后指望主项目自动识别的方案都会失败。真正能用的，只有 path 类型仓库——它让 Composer 把本地目录当远程包源来处理，绕过 Packagist、跳过元数据请求，直接读取目标目录下的 composer.json。
必须把每个模块放在独立子目录（如 modules/user、modules/payment），每个目录下有合法的 composer.json，且 name 字段与主项目 require 中声明的完全一致（包括大小写）。
-
repositories必须写在主项目的composer.json里，不能写在模块自己的composer.json中 -
url值必须是相对路径（如"./modules/user"），绝对路径在 Windows 下极易静默失效 - 模块目录下必须已执行
git init && git commit，否则 Composer 直接跳过该目录
require 版本号写 * 就够了，别碰 dev-main
很多人卡在 composer require vendor/module:dev-main 报 “Could not find package”，其实根本不是版本写错，而是 Composer 还没“看见”这个路径。只要 repositories 配对、name 对齐、Git 初始化完成，require 写 "*" 就能命中本地包最新提交。
dev-main 这类分支名只在你明确想绑定某个 Git 分支时才需要，日常开发反而容易因分支不存在或未 push 导致失败。而 "*" 会自动匹配本地包 composer.json 中的 "version": "dev-main" 或 "version": "1.0.x-dev"，更稳。
- 模块
composer.json中的version字段建议固定为"dev-main"，避免每次改代码都手动 bump - 如果模块还没 Git 提交，
composer update会直接忽略它，不会报错也不会提示 - 运行
composer show vendor/module可确认是否识别成功；输出里出现source: path ./modules/module才算到位
改代码不生效？检查 symlink 是否启用
默认情况下，Composer 对 path 包采用软链接（symlink）安装，改模块代码会立刻反映到主项目中。但 Windows 默认禁用 symlink，Linux/macOS 虽支持，但某些容器或 CI 环境也会 fallback 到 copy 模式。
关键动作是在 repositories 条目里显式加 "options": {"symlink": true}：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"type": "path",
"url": "./modules/user",
"options": {"symlink": true}
}
然后执行 composer update vendor/user（不是 install），才能刷新链接指向。
- Linux/macOS 验证：运行
ls -la vendor/vendor/user，看到->指向源目录才算成功 - Windows 验证：运行
dir vendor endoruser，类型应显示为“快捷方式” - 若必须用 copy 模式（如 CI），可设
"preferred-install": {"vendor/user": "dist"}
autoload 映射必须由模块自己声明
主项目不会替你加载模块里的类。每个模块的 composer.json 必须包含 autoload 配置，且命名空间要与实际目录结构严格对应。
比如模块路径是 modules/user/src/Service/UserService.php，命名空间是 MyAppUserService，那它的 composer.json 就得这么写：
{
"name": "myapp/user",
"autoload": {
"psr-4": {
"MyApp\User\": "src/"
}
}
}
主项目执行 composer dump-autoload 后，vendor/autoload.php 才会包含这个映射。
- 不要在主项目
composer.json的autoload里手动加模块路径——这会破坏模块封装性，且下次composer update可能被覆盖 - 模块内如有测试类，可额外加
"autoload-dev"，避免污染生产自动加载 - 如果类仍找不到，先确认
composer show myapp/user输出中是否有autoload: psr-4行
复杂点在于：所有模块的 name、路径、Git 状态、autoload 配置这四件事必须同时成立，缺一不可。少做一步，就表现为“装上了但用不了”或者“根本装不上”，而错误信息往往不提示具体哪一环断了。
