git subtree在本地合并子仓库到主仓库

如果你只想在本地将拆分后的子仓库合并到主仓库，而不涉及远程操作，可以使用 git subtree add 或 git subtree merge 命令来完成。以下是具体的步骤：

前提条件

假设你已经通过 git subtree split 拆分出了一个子仓库，并且子仓库的本地路径为 ./subtree-repo，主仓库的路径为 ./main-repo。

步骤 1：在主仓库中添加子仓库作为远程仓库

在主仓库中，将本地子仓库添加为一个远程仓库。这一步是通过 git remote add 命令完成的。

cd main-repo
git remote add -f subtree-repo ../subtree-repo

• -f 参数会自动拉取本地子仓库的所有分支。
• subtree-repo 是你为本地子仓库指定的远程仓库名称。
• ../subtree-repo 是子仓库的本地路径。

步骤 2：将子仓库的内容合并到主仓库的指定目录

使用 git subtree add 或 git subtree merge 命令，将子仓库的内容合并到主仓库的指定目录中。

如果是第一次合并子仓库：

git subtree add --prefix=subdir subtree-repo main --squash

• --prefix=subdir 指定子仓库的内容将被放置在主仓库的 subdir 目录下。
• subtree-repo 是远程仓库的名称。
• main 是子仓库的分支名称（根据实际情况替换）。
• --squash 会将子仓库的所有更改压缩为一个提交。

如果之前已经添加过子仓库，现在只需要更新内容：

git subtree merge --prefix=subdir subtree-repo/main --squash

• --prefix=subdir 指定子仓库的内容将被放置在主仓库的 subdir 目录下。
• subtree-repo/main 是子仓库的分支路径。
• --squash 会将子仓库的更改压缩为一个提交。

步骤 3：解决冲突并提交

如果在合并过程中出现冲突，需要手动解决冲突，然后提交更改：

git add .
git commit -m "Merge subtree-repo into subdir"

步骤 4：验证合并结果

检查主仓库的 subdir 目录，确认子仓库的内容已经正确合并到主仓库中。

除了使用 git subtree 和 git remote 的方法外，还有其他几种方式可以将本地子仓库的内容合并到主仓库中。以下是几种替代方法：

---

方法 1：手动复制文件

如果子仓库的内容较少，或者你只需要部分文件，可以手动将子仓库的文件复制到主仓库中。

操作步骤：

1. 复制文件 ：

   cp -r <子仓库路径>/* <主仓库路径>/目标目录/

2. 提交更改 ：

   cd <主仓库路径>
   git add .
   git commit -m "Manually merge sub-repo content"

优点：

• 简单直接，适合文件较少的场景。
• 可以自由选择需要的文件。

缺点：

• 不保留子仓库的历史记录。
• 如果文件较多，容易出错。

---

方法 2：使用 git filter-branch 或 git filter-repo

如果需要保留子仓库的完整历史记录，并将其完整地合并到主仓库中，可以使用 git filter-branch 或更现代的 git filter-repo 工具来重写子仓库的历史，使其看起来像是从主仓库中分离出来的。

操作步骤（以 git filter-repo 为例）：

1. 安装 git filter-repo：

   pip install git-filter-repo

2. 重写子仓库的历史：

   cd <子仓库路径>
   git filter-repo --path <子仓库中的目标目录> --to-subdirectory-filter <主仓库中的目标目录>

   这会将子仓库的历史重写，使其看起来像是从主仓库的某个目录中分离出来的。

3. 将重写后的子仓库合并到主仓库：

   cd <主仓库路径>
   git remote add sub-repo <子仓库路径>
   git fetch sub-repo
   git merge sub-repo/main

优点：

• 完整保留子仓库的历史记录。
• 灵活性高，可以重写历史。

缺点：

• 操作复杂，需要安装额外工具。
• 如果子仓库和主仓库有冲突，解决起来可能比较麻烦。

---

方法 3：使用 git archive 和 git apply

如果只需要子仓库的最新状态，而不需要保留历史记录，可以使用 git archive 将子仓库的当前状态导出为一个压缩包，然后在主仓库中解压并提交。

操作步骤：

1. 导出子仓库的当前状态：

   cd <子仓库路径>
   git archive --format=tar HEAD | gzip > ../sub-repo.tar.gz

2. 在主仓库中解压并提交：

   cd <主仓库路径>
   tar -xzf ../sub-repo.tar.gz -C <目标目录>
   git add <目标目录>
   git commit -m "Merge sub-repo content"

优点：

• 简单快速，只涉及当前状态。
• 不需要复杂的合并操作。

缺点：

• 不保留子仓库的历史记录。

---

方法 4：使用 git subtree 的 --rejoin 选项

如果你之前使用 git subtree split 拆分了子仓库，并且现在希望将拆分后的子仓库重新合并回主仓库，可以使用 --rejoin 选项。

操作步骤：

1. 合并子仓库：

   cd <主仓库路径>
   git subtree add --prefix=<目标目录> <子仓库路径>/.git main --squash --rejoin

   --rejoin 选项会尝试恢复拆分时的历史记录，使得合并后的主仓库历史更加完整。

优点：

• 保留子仓库的历史记录。
• 操作相对简单。

缺点：

• 如果子仓库和主仓库的目录结构有冲突，可能需要手动解决。

当然，除了前面提到的几种方法，还有一些其他方式可以将本地子仓库的内容合并到主仓库中。这些方法可能更适合特定场景或需求，以下是一些补充方案：

---

方法 6：使用 git read-tree 和 git merge-tree

git read-tree 和 git merge-tree 是 Git 的底层命令，可以用来直接操作树对象（tree objects）。这种方法适合需要手动处理合并冲突或需要更细粒度控制的场景。

操作步骤：

1. 在主仓库中创建一个新的分支：

   cd <主仓库路径>
   git checkout -b merge-subrepo

2. 将子仓库的最新提交引入主仓库：

   git remote add sub-repo <子仓库路径>
   git fetch sub-repo

3. 使用 git read-tree 将子仓库的树对象读入主仓库的索引：

   git read-tree --prefix=<目标目录>/ sub-repo/main

   这会将子仓库的文件树加载到主仓库的索引中，并放置在指定的目录下。

4. 合并更改并解决冲突：

   git checkout main
   git merge -X theirs merge-subrepo

   如果使用 git merge-tree，可以手动处理合并冲突：

   git merge-tree $(git merge-base main merge-subrepo) main merge-subrepo

5. 提交更改：

   git add .
   git commit -m "Merge sub-repo content using read-tree"

优点：

• 提供了更底层的控制，适合复杂的合并场景。
• 可以手动处理合并冲突。

缺点：

• 操作较为复杂，需要对 Git 的底层机制有一定了解。

---

方法 7：使用 git subtree 的 --onto 选项

如果你需要将子仓库的内容合并到主仓库的某个特定分支或提交上，可以使用 git subtree 的 --onto 选项。

操作步骤：

1. 在主仓库中添加子仓库：

   cd <主仓库路径>
   git remote add sub-repo <子仓库路径>
   git fetch sub-repo

2. 使用 git subtree 合并子仓库到指定分支：

   git subtree add --prefix=<目标目录> --onto=<主仓库分支名> sub-repo/main --squash

   例如，将子仓库的内容合并到主仓库的 feature 分支：

   git subtree add --prefix=subdir --onto=feature sub-repo/main --squash

优点：

• 提供了更灵活的合并目标选择。
• 保留了子仓库的历史记录（可选）。

缺点：

• 如果主仓库和子仓库的目录结构冲突较多，可能需要手动解决。

---

方法 8：使用 git subtree 的 --rejoin 和 --onto 组合

如果你之前使用 git subtree split 拆分了子仓库，并且现在希望将拆分后的子仓库重新合并到主仓库的某个特定分支上，可以结合使用 --rejoin 和 --onto 选项。

操作步骤：

1. 在主仓库中添加子仓库：

   cd <主仓库路径>
   git remote add sub-repo <子仓库路径>
   git fetch sub-repo

2. 合并子仓库到主仓库的指定分支：

   git subtree add --prefix=<目标目录> --onto=<主仓库分支名> sub-repo/main --squash --rejoin

   例如，将子仓库的内容合并到主仓库的 develop 分支：

   git subtree add --prefix=subdir --onto=develop sub-repo/main --squash --rejoin

优点：

• 保留了子仓库的历史记录。
• 可以将子仓库的内容合并到主仓库的任意分支。

缺点：

• 如果主仓库和子仓库的目录结构冲突较多，可能需要手动解决。

---

方法 9：使用 git format-patch 和 git am

如果你只需要将子仓库的某些提交合并到主仓库中，可以使用 git format-patch 将子仓库的提交导出为补丁文件，然后在主仓库中应用这些补丁。

操作步骤：

1. 在子仓库中生成补丁文件：

   cd <子仓库路径>
   git format-patch <起始提交>..<结束提交> -o ../patches

   这会将指定范围的提交导出为补丁文件，保存到 ../patches 目录中。

2. 在主仓库中应用补丁：

   cd <主仓库路径>
   git am ../patches/*.patch

优点：

• 可以选择性地合并特定提交。
• 保留了提交的历史记录。

缺点：

• 如果补丁文件较多，操作可能比较繁琐。
• 如果主仓库和子仓库的文件路径冲突，可能需要手动解决。

---

方法 10：使用 git worktree 和 git merge

如果你需要在主仓库中临时创建一个工作树（worktree），并将其与子仓库的内容合并，可以使用 git worktree 和 git merge。

操作步骤：

1. 在主仓库中创建一个新的工作树：

   cd <主仓库路径>
   git worktree add ../main-repo-worktree <目标分支>

2. 在工作树中合并子仓库的内容：

   cd ../main-repo-worktree
   git remote add sub-repo <子仓库路径>
   git fetch sub-repo
   git merge sub-repo/main

3. 解决冲突并提交更改：

   git add .
   git commit -m "Merge sub-repo content using worktree"

4. 将更改推回主仓库：

   git push origin <目标分支>

优点：

• 提供了独立的工作环境，适合复杂的合并操作。
• 可以在不影响主仓库的情况下进行测试。

缺点：

• 操作较为复杂，需要管理多个工作树。

---

总结

以上是几种补充的合并方法，每种方法都有其适用场景和优缺点。你可以根据具体需求选择合适的方法：

• 如果需要保留历史记录，可以使用 git subtree 的 --rejoin 或 git filter-repo。
• 如果只需要当前状态，可以使用 git archive 或手动复制文件。
• 如果需要选择性合并提交，可以使用 git cherry-pick、git rebase 或 git format-patch。
• 如果需要更灵活的工作环境，可以使用 git worktree。

希望这些方法能帮助你更灵活地完成子仓库到主仓库的合并！