composer本身不支持多仓库自动同步，它仅负责依赖解析与安装，不处理代码同步；需借助git-subrepo或yq+shell等外部工具链实现同步，且同步后必须运行composer update --lock更新lock文件以保证一致性。
Composer 本身不支持多仓库自动同步
Composer 是依赖管理工具，不是代码同步工具。它只负责从配置的 repositories 拉取包、解析依赖、安装到 vendor/，不会反向同步代码变更、推送提交或维护多个 Git 仓库间的一致性。所谓“Multi-Repo 同步管理”，必须靠外部脚本或工具链补足，Composer 只承担其中“依赖解析”和“版本锁定”环节。
常见误操作是试图在 composer.json 里堆砌多个 path 类型仓库并期望它们自动联动 —— 这会导致 composer install 失败或版本冲突，因为 path 仓库不参与 Packagist 式的语义化版本仲裁。
-
path仓库仅用于本地开发调试，不能用于生产环境多仓库协同 - 多个
vcs类型仓库（如 GitHub）可共存，但 Composer 不会自动拉取/推送/合并它们的代码 -
composer update只更新vendor/和composer.lock，不触碰任何源码仓库的 Git 状态
用 git-subrepo 或 yq + shell 实现基础同步逻辑
真正可行的“多仓库同步”，本质是用 Git 工具链统一操作多个目录，再让 Composer 消费这些已同步好的代码。推荐两种轻量路径：
若子模块需保持独立 Git 历史且可双向同步，用 git-subrepo（比 git submodule 更友好）：
git subrepo clone https://github.com/org/package-a.git packages/package-a<br>git subrepo pull packages/package-a<br>git subrepo push packages/package-a
若只是批量执行相同 Git 操作（如统一拉取、打 tag、推送），用 yq 解析 composer.json 中的 repositories 列表，再循环执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
yq e '.repositories[] | select(.type == "vcs") | .url' composer.json | while read url; do<br> dir=$(basename "$url" .git)<br> [ -d "$dir" ] && (cd "$dir" && git pull origin main)<br>done
- 注意：上述脚本只处理
vcs类型仓库；package或composer类型仓库无对应本地目录，不可同步 - 所有同步操作必须在
composer install前完成，否则composer.lock中记录的 commit hash 可能与本地实际代码不一致 - 避免在
packages/下直接修改代码后忘记git add/commit/push—— Composer 不会帮你提交
composer.json 中 repositories 的写法直接影响同步可行性
要让外部同步脚本能识别目标仓库，repositories 字段必须结构清晰、字段完整。尤其注意 url 和 canonical 的一致性：
{<br> "type": "vcs",<br> "url": "https://github.com/org/package-b.git"<br>}
这个 url 必须是可被 git clone 直接使用的地址，且应与你本地克隆路径严格对应（如 packages/package-b）。否则同步脚本无法定位目录。
- 不要用 SSH URL（如
git@github.com:org/pkg.git）除非所有机器都配好 SSH key；HTTP(S) 更稳妥 - 避免在
repositories中混用path和vcs类型 —— 它们生命周期完全不同，强行共存极易导致composer update报错Could not find package xxx at any version -
packagist.org默认禁用，若启用"packagist": false，则所有依赖必须显式声明在repositories中，漏一个就会失败
同步后必须重生成 lock 文件才能保证一致性
即使你手动同步了所有子仓库的代码，Composer 仍按 composer.lock 中记录的 commit hash 或版本号安装。如果子仓库有新提交但 lock 文件没更新，composer install 会回退到旧版本，导致“代码已同步但 vendor 未生效”的假象。
- 每次完成 Git 同步后，必须运行
composer update --lock（不改依赖树，只刷新 hash）或composer update vendor/package-name --with-dependencies - CI 流程中建议把同步脚本和
composer update --lock绑定为原子操作，避免人工遗漏 - 留意
composer.lock文件体积可能剧增 —— 每个vcs包都会记录完整 commit hash 和 dist source，多人协作时易引发合并冲突
多仓库同步不是配置问题，而是工作流设计问题。核心矛盾永远在 Git 和 Composer 的职责边界上：Git 管代码历史与变更，Composer 管依赖快照与安装。强行让 Composer 承担同步职责，只会让问题更隐蔽。
