关于 Git 子树合并

关于子树合并

通常，子树合并用于在一个代码仓库中包含另一个代码仓库。 “子仓库”存储在主仓库的文件夹中。

解释子树合并的最佳方式是举例说明。我们将：

创建一个名为的空存储库，用于表示我们的项目。
将另一个名为的存储库作为子树合并到其中。
项目将使用该子项目，就像它也属于同一存储库一样。
将更新从某处提取到我们的某个项目中。

创建用于子树合并的空仓库

创建一个新目录并切换到该目录。
```
mkdir test
cd test
```

初始化新的 Git 存储库。

$ git init
> Initialized empty Git repository in /Users/octocat/tmp/test/.git/

创建并提交新文件。

$ touch .gitignore
$ git add .gitignore
$ git commit -m "initial commit"
> [main (root-commit) 3146c2a] initial commit
>  0 files changed, 0 insertions(+), 0 deletions(-)
>  create mode 100644 .gitignore

将新仓库作为子树添加

新增指向我们感兴趣的单独项目的远程 URL。

$ git remote add -f spoon-knife https://github.com/octocat/Spoon-Knife.git
> Updating spoon-knife
> warning: no common commits
> remote: Counting objects: 1732, done.
> remote: Compressing objects: 100% (750/750), done.
> remote: Total 1732 (delta 1086), reused 1558 (delta 967)
> Receiving objects: 100% (1732/1732), 528.19 KiB | 621 KiB/s, done.
> Resolving deltas: 100% (1086/1086), done.
> From https://github.com/octocat/Spoon-Knife
>  * [new branch]      main     -> Spoon-Knife/main

将项目合并到本地 Git 项目。这不会在本地更改任何文件，但会为下一步准备 Git。

如果您使用的是 Git 2.9 或更高版本：

$ git merge -s ours --no-commit --allow-unrelated-histories spoon-knife/main
> Automatic merge went well; stopped before committing as requested

如果您使用的是 Git 2.8 或更低版本：

$ git merge -s ours --no-commit spoon-knife/main
> Automatic merge went well; stopped before committing as requested

创建新目录“spoon-knife”并将项目的 Git 历史记录复制到其中。

$ git read-tree --prefix=spoon-knife/ -u spoon-knife/main
> fatal: refusing to merge unrelated histories

提交更改以确保保存其完整性和安全。

$ git commit -m "Subtree merged in spoon-knife"
> [main fe0ca25] Subtree merged in spoon-knife

虽然我们只添加了一个子项目，但是可在 Git 仓库中加入任意数量的子项目。

提示

如果你以后创建存储库的全新克隆，系统不会为你创建你已添加的远程库。您将必须使用命令再次添加它们。

与更新和更改同步

添加子项目时，它不会自动与上游更改保持同步。您需要使用以下命令更新子项目：

git pull -s subtree REMOTE-NAME BRANCH-NAME

对于上述示例，将是：

git pull -s subtree spoon-knife main

其他阅读材料

《Pro Git》一书中的“高级合并”章节
如何使用子树合并策略

本文内容

关于子树合并

创建用于子树合并的空仓库

将新仓库作为子树添加

与更新和更改同步

其他阅读材料