我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

此版本的 GitHub Enterprise 已停止服务 2021-03-02. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

关于 Git 子树合并

如果需要管理单一仓库中的多个项目,可以使用子树合并来处理所有引用。

本文内容

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

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

  • 创建一个名为 test 的空仓库,表示我们的项目
  • 将另一个仓库 Spoon-Knife 作为子树合并到其中。
  • 如果该子项目属于同一仓库,test 项目会使用它。
  • Spoon-Knife 提取更新到 test 项目。

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

  1. 打开 Terminal(终端)Terminal(终端)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 git@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 git://github.com/octocat/Spoon-Knife
    >  * [new branch]      main     -> Spoon-Knife/main
  2. Spon-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 仓库中加入任意数量的子项目。

提示:如果以后创建仓库的全新克隆,不会为您创建您添加的远程 Url。 您需要再次使用 the git remote add 命令添加它们

同步更新和更改

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

$ git pull -s subtree remotename branchname

对于上述示例,将是:

$ git pull -s subtree spoon-knife main

延伸阅读