关于 Git 子树合并

关于子树合并

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

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

• 创建一个名为test的空仓库，代表我们的项目。
• 将另一个仓库作为名为Spoon-Knife的子树合并到其中。
• test项目将使用该子项目，就像它是同一仓库的一部分一样。
• 将Spoon-Knife的更新提取到我们的test项目中。

为子树合并设置空仓库

1. 打开终端终端Git Bash。

2. 创建一个新目录并导航到它。

   mkdir test
   cd test
   

3. 初始化一个新的 Git 仓库。

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

4. 创建并提交一个新文件。

   $ 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
   

添加新的仓库作为子树

1. 添加一个新的远程 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
   

2. 将 Spoon-Knife 项目合并到本地 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
   

3. 创建一个名为 spoon-knife 的新目录，并将 Spoon-Knife 项目的 Git 历史记录复制到其中。

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

4. 提交更改以确保安全。

   $ 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 书籍的“高级合并”章节
• "如何使用子树合并策略"