Git rebase - 在 fork 点模式下提交选择

Question

阅读 git rebase 和 git merge-base man 文档:

After working on the topic branch created with git checkout -b topic origin/master, the history of remote-tracking branch origin/master may have been rewound and rebuilt, leading to a history of this shape:

                        o---B1
                       /
       ---o---o---B2--o---o---o---B (origin/master)
               \
                B3
                 \
                  Derived (topic)

where origin/master used to point at commits B3, B2, B1 and now it points at B, and your topic branch was started on top of it back when origin/master was at B3. This mode uses the reflog of origin/master to find B3 as the fork point, so that the topic can be rebased on top of the updated origin/master by:

$ fork_point=$(git merge-base --fork-point origin/master topic)
$ git rebase --onto origin/master $fork_point topic

$fork_point 将(如果我理解正确的话)成为提交对象 B3，因此提交 B3..topic 将重新定位到 origin/master 分支。

Q1 为什么省略 B3 提交是有用的？ topic 分支的提交建立在 B3 提交之上，因此省略它意味着它的修改将在 origin 的故事中丢失/master 分支。重新设置 B3 提交 和 topic 分支的基址会导致更清晰的历史记录，不是吗？

Q2 有人可以链接/简要描述 git 工作流中 --fork-point 选项的实际用例吗？

Answer 1

你是正确的，$fork_point 将是 B3。

我相信这里的意图是省略 B3 作为“不是你的提交”。

我认为 Git 人员在这里绘制的图表不太好。以下是我将如何重绘和重写它而不会对其进行太多更改(尽管我可能只是重新写下每次提交)。

---

您首先克隆(或以其他方式更新到)一些 (origin) 存储库，其图表以提交 B3 结尾，然后您创建一个主题分支并进行一些提交(小号):

...--o---F---B3    <-- origin/master
              \
               G   <-- topic

随着时间的推移，有了额外的 git fetch-es 和 git commit，您的提交图现在看起来像这样:

...--o---F---B3--B2--B1    <-- origin/master
              \
               G---H---I   <-- topic

但是，突然之间，在 另一个 git fetch 之后，您自己的提交图现在看起来像这样:

                 o---B1'       <-- origin/foo
                /
...o---F---B2'-o---o---o---B   <-- origin/master
        \
         B3--G---H---I         <-- topic

也就是说，Git 现在会认为提交 B3 属于您的主题分支，而实际上，您的 工作从提交 G 开始。拥有名为 origin 的存储库的人实际上已经声明提交 B3 很糟糕，应该扔掉。 (他们在他们的 master 上保留了一份 B2 作为 B2'，而 B1 作为 B1' 在他们的 foo 上。)

如果你只是简单地 git rebase，你会将原始提交 B3 复制到新副本 B3'(同时也复制 G-H-I):

                 o---B1'                     <-- origin/foo
                /
...o---F---B2'-o---o---o---B                 <-- origin/master
                            \
                             B3'-G'--H'--I'  <-- topic

但你更喜欢:

                 o---B1'                 <-- origin/foo
                /
...o---F---B2'-o---o---o---B             <-- origin/master
                            \
                             G'--H'--I   <-- topic

要让 git rebase 执行此操作，您必须指示 Git 定位提交 B3。 origin/master 的 reflog 包含所有 F、B3、B2 和 B1 中(在至少一个 reflog 条目下，在本例中包括 origin/master@{1})，而您自己的 topic 有 F 和 B3，但不包含 B2 和 B1。因此 --fork-point 选择 B3 作为最新的(tip-most)共享提交，而不是 F。

---

这里的关键句子/想法是上游存储库编写者打算完全丢弃提交 B3。

(您应该如何确定这一点有点神秘。B2' 和 B1' 是副本可能并不明显，如果需要 rebase ，例如，丢弃一个不应该提交的文件——它位于 B1 中，这就是为什么 B1 也被丢弃的原因。这个文件现在被省略的事实在 B2' 和 B3' 中使它们不是补丁等效的，因此显然不是副本。)

(注意你自己的master也仍然指向B3!)