执行git pull --rebase=merges时Rebasing含义及计数异常的疑问

问题背景 #

执行git pull -v --rebase=merges时，日志出现Rebasing (1/4)类输出，结合以下具体场景：

本地初始提交记录 #

* be23d923d (HEAD -> bot) Dump more info
* 506b1b5a7 (office/bot) Fix IP for registry.gitlab.office
* fb7e89677 Show build log on failure
*   58c2e3606 Merge branch 'implement_test' into test2

执行命令后的提交记录 #

* 42852fd6b (HEAD -> bot) Dump more info
* a3c657c09 (office/bot) Echo $IMAGE_TAG
* 506b1b5a7 Fix IP for registry.gitlab.office
* fb7e89677 Show build log on failure
*   58c2e3606 Merge branch 'implement_test' into test2

命令执行日志 #

remote: Enumerating objects: 5, done.
remote: Counting objects: 100% (5/5), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 2), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), 287 bytes | 287.00 KiB/s, done.
From office-repo:office/bot
   506b1b5a7..a3c657c09  bot        -> office/bot
 = [up to date]          prod       -> office/prod
Changes from 506b1b5a7ebcf0e9778279f5de90bd67c0462e0a to a3c657c099ea0077a22d77de10029dd35be1058d:
 .gitlab-ci.yml | 1 +
 1 file changed, 1 insertion(+)
Rebasing (1/4)
Rebasing (2/4)
Rebasing (3/4)
 .gitlab-ci.yml | 1 +
 1 file changed, 1 insertion(+)
Successfully rebased and updated refs/heads/bot.

远程仓库新提交 #

远程仅存在1个新提交：

git log -w -b -p --ignore-blank-lines --full-history 506b1b5a7..a3c657c09
commit a3c657c099ea0077a22d77de10029dd35be1058d (office/bot)
Author: Administrator <admin@example.com>
Date:   Sun Dec 18 15:54:06 2022 +0000

    Echo $IMAGE_TAG

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 4ca4f8769..e4e25a947 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -23,6 +23,7 @@ build-job:
     - echo $CI_REGISTRY_PASSWORD | docker login -u $CI_REGISTRY_USER $CI_REGISTRY --pass>
     - docker build -t $IMAGE_TAG .
     - docker push $IMAGE_TAG
+    - echo $IMAGE_TAG
 
 test-job1:
   stage: test

核心问题解答 #

1. Rebasing (1/4)的含义 #

Rebasing (N/M)是Git变基时的进度提示：

• M是Git需要处理的总提交/节点数，在--rebase=merges模式下，会包含普通提交、合并提交的父节点等，因为该模式要保留本地的合并提交结构
• N是当前正在处理的第N个节点

2. 为何出现3次Rebasing记录而非预期的1次 #

你直观认为只需要处理1次本地提交，但--rebase=merges的处理逻辑更复杂：

• 第一步：处理基线合并提交的第一个父节点（确保合并结构的关联）
• 第二步：处理基线合并提交的第二个父节点
• 第三步：将本地独有的提交be23d923d重新应用到远程新提交a3c657c09之上

这三个处理步骤对应日志里的3次Rebasing记录，并非只处理单个提交。

3. 为何缺失Rebasing (4/4) #

计数里的第4个处理项是更新本地分支指针（把bot分支的HEAD指向变基后的最终提交42852fd6b），这个操作属于变基的收尾步骤，Git不会为它打印Rebasing (N/M)的日志，所以你看不到Rebasing (4/4)的输出。

内容的提问来源于stack exchange，提问作者Eugen Konkov