Git
章节 ▾ 第二版

7.12 Git 工具 - 打包

打包

虽然我们已经介绍了通过网络传输 Git 数据的常见方式（HTTP、SSH 等），但实际上还有另一种不常用的方式，它实际上非常有用。

Git 能够将数据“打包”成单个文件。这在各种情况下都很有用。也许您的网络已断开，您想将更改发送给您的同事。也许您正在异地工作，出于安全原因无法访问本地网络。也许您的无线/以太网卡坏了。也许您暂时无法访问共享服务器，您想通过电子邮件发送更新给某人，而且您不想通过format-patch传输 40 次提交。

这就是git bundle命令大显身手的地方。bundle命令将通常通过git push命令在网络上传输的所有数据打包成一个二进制文件，您可以通过电子邮件发送给某人或将其放在闪存驱动器上，然后解包到另一个仓库。

让我们看一个简单的例子。假设您有一个包含两个提交的仓库

$ git log
commit 9a466c572fe88b195efd356c3f2bbeccdb504102
Author: Scott Chacon <[email protected]>
Date:   Wed Mar 10 07:34:10 2010 -0800

    Second commit

commit b1ec3248f39900d2a406049d762aa68e9641be25
Author: Scott Chacon <[email protected]>
Date:   Wed Mar 10 07:34:01 2010 -0800

    First commit

如果您想将该仓库发送给某人，而且您无法访问要推送到其中的仓库，或者只是不想设置仓库，您可以使用git bundle create进行打包。

$ git bundle create repo.bundle HEAD master
Counting objects: 6, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (6/6), 441 bytes, done.
Total 6 (delta 0), reused 0 (delta 0)

现在您有一个名为repo.bundle的文件，其中包含重新创建仓库的master分支所需的所有数据。在使用bundle命令时，您需要列出要包含的所有引用或特定提交范围。如果您打算在其他地方克隆它，则应添加 HEAD 作为引用，就像我们在这里所做的那样。

您可以通过电子邮件将此repo.bundle文件发送给其他人，或者将其放在 USB 驱动器上并将其传递给他们。

在另一端，假设您收到了此repo.bundle文件，并且想要处理该项目。您可以从二进制文件克隆到某个目录中，就像从 URL 中克隆一样。

$ git clone repo.bundle repo
Cloning into 'repo'...
...
$ cd repo
$ git log --oneline
9a466c5 Second commit
b1ec324 First commit

如果您未在引用中包含 HEAD，则还必须指定-b master或包含的任何分支，否则它将不知道要检出哪个分支。

现在假设您对其进行了三次提交，并且想通过 USB 驱动器或电子邮件发送这些新的提交。

$ git log --oneline
71b84da Last commit - second repo
c99cf5b Fourth commit - second repo
7011d3d Third commit - second repo
9a466c5 Second commit
b1ec324 First commit

首先，我们需要确定要包含在包中的提交范围。与网络协议不同，网络协议会自动找出要通过网络传输的最小数据集，而我们要手动确定。现在，您可以直接将整个存储库打包，这也能正常工作，但最好只打包差异 - 也就是我们本地刚做的三个提交。

为此，您需要计算差异。正如我们在提交范围中所述，您可以通过多种方式指定提交范围。要获取我们master分支中三个不在我们最初克隆的分支中的提交，可以使用类似origin/master..master或master ^origin/master的命令。您可以使用log命令进行测试。

$ git log --oneline master ^origin/master
71b84da Last commit - second repo
c99cf5b Fourth commit - second repo
7011d3d Third commit - second repo

现在我们已经有了要包含在包中的提交列表，让我们把它们打包。我们可以使用git bundle create命令，并提供要创建的包的名称以及要打包的提交范围。

$ git bundle create commits.bundle master ^9a466c5
Counting objects: 11, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (9/9), 775 bytes, done.
Total 9 (delta 0), reused 0 (delta 0)

现在，我们在目录中有一个commits.bundle文件。如果我们将它发送给我们的合作伙伴，她就可以将它导入到原始存储库中，即使在此期间存储库中已经进行了更多工作。

当她获得包时，她可以在将其导入到她的存储库之前检查它包含的内容。第一个命令是bundle verify命令，它将确保文件实际上是一个有效的 Git 包，并且您拥有所有必要的祖先以便正确地重构它。

$ git bundle verify ../commits.bundle
The bundle contains 1 ref
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master
The bundle requires these 1 ref
9a466c572fe88b195efd356c3f2bbeccdb504102 second commit
../commits.bundle is okay

如果打包程序创建的包只包含他们最后做的两个提交，而不是所有三个提交，那么原始存储库将无法导入它，因为它缺少必要的历史记录。verify命令将显示以下内容

$ git bundle verify ../commits-bad.bundle
error: Repository lacks these prerequisite commits:
error: 7011d3d8fc200abe0ad561c011c3852a4b7bbe95 Third commit - second repo

但是，我们的第一个包是有效的，因此我们可以从中提取提交。如果您想查看包中可以导入的分支，还有一个命令可以列出所有分支头

$ git bundle list-heads ../commits.bundle
71b84daaf49abed142a373b6e5c59a22dc6560dc refs/heads/master

verify子命令也会告诉您分支头。目的是查看可以拉取的内容，因此您可以使用fetch或pull命令从该包中导入提交。在这里，我们将从包的master分支提取到我们存储库中名为other-master的分支

$ git fetch ../commits.bundle master:other-master
From ../commits.bundle
 * [new branch]      master     -> other-master

现在我们可以看到，我们已经在other-master分支上获得了导入的提交，以及我们同时在自己的master分支中进行的任何提交。

$ git log --oneline --decorate --graph --all
* 8255d41 (HEAD, master) Third commit - first repo
| * 71b84da (other-master) Last commit - second repo
| * c99cf5b Fourth commit - second repo
| * 7011d3d Third commit - second repo
|/
* 9a466c5 Second commit
* b1ec324 First commit

因此，git bundle在没有合适的网络或共享存储库来进行网络型操作时，非常有用。

scroll-to-top