Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
GitHub AE is currently under limited release.

关于 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
  4. 提交更改以确保其安全。

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

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

提示:如果你以后创建存储库的全新克隆,系统不会为你创建你已添加的远程库。 必须使用 git remote add 命令 来添加它们。

同步更新和更改

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

$ git pull -s subtree REMOTE-NAME BRANCH-NAME

对于上述示例,将是:

$ git pull -s subtree spoon-knife main

延伸阅读