子树策略合并是什么

git merge -s subtree 把对方仓库的提交对齐到当前仓库的某个子目录再合并，专治没有子树元数据的「库中库」场景：历史上一直是手工把对方代码拷进某个目录，现在想用正式合并通道接管。该策略靠启发式比对树结构与目录偏移，判断对方内容在本地对应的前缀，因此依赖双方目录结构保持稳定；新项目更推荐用 git subtree 命令或子模块。

基本信息

典型使用场景

• 历史遗留的 vendor 目录：一直是人工复制对方代码，换成正式合并通道。
• 一次性并入外部仓库：不引入 subtree 元数据，只求把历史对齐。
• 应急并入上游修复：把对方某分支的修复合并进本地子目录。
• 迁移过渡：先用它对齐现状，再逐步切换到 git subtree 或子模块。
• 多来源聚合：仓库里汇集了多个外部组件，逐一建立合并关系。

常用示例

git remote add vendor https://example.com/vendor/lib.git   # 加远端
git fetch vendor                                          # 取回对方历史
git merge -s subtree -X subtree=vendor/lib vendor/main    # 对齐合并到子目录
git log --oneline --graph -5                              # 核对合并结果与方向

三种方案对照