如何以编程方式快进单个 git 提交？

Question

我定期从 git 收到如下消息：

Your branch is behind the tracked remote branch 'local-master/master' 
by 3 commits, and can be fast-forwarded.

我希望能够在 shell 脚本中编写可以执行以下操作的命令：

1. 如何判断我当前的分支是否可以从远程分支快速转发它正在跟踪？

2. 我如何知道我的分支“后面”有多少提交？

3. 如何快速前进一次提交，例如，我的本地分支将从“落后 3 次提交”变为“落后 2 次提交”？

（对于那些感兴趣的人，我正在尝试组装一个高质量的 git/darcs 镜像。）

Answer 1

替代方法

您提到您正在为 Git 和 Darcs 开发某种镜像。您可以查看 git fast-import 和 git fast-export 命令，看看它们是否提供了更好的方法来管理您需要提取/提供的数据。

如何判断分支是否可以快进到其上游分支

这分为两个部分。首先，您必须知道或确定哪个分支是当前分支的“上游”。然后，一旦您知道如何引用上游，您就可以检查快进的能力。

查找分支的上游

Git 1.7.0 有一种方便的方法来查询分支跟踪哪个分支（其“上游”分支）。 @{upstream} 对象规范语法可以用作分支说明符。作为一个裸名称，它指的是当前签出的分支的上游分支。作为后缀，它可用于查找当前未签出的分支的上游分支。

对于 1.7.0 之前的 Git，您必须自己解析分支配置选项（branch.name.remote 和 branch.name.merge）。或者，如果您有标准命名约定，则可以使用它来确定上游分支的名称。

在这个答案中，我将编写 upstream 来指代当前分支上游分支尖端的提交。

检查快进的能力

提交 A 处的分支可以快进到提交 B 当且仅当 A 是 B 的祖先时。gyim

展示了一种检查此条件的方法（列出从 B 可达的所有提交并检查对于列表中的 A）。也许检查此条件的一个更简单的方法是检查 A 是否是 A 和 B 的合并基础。

can_ff() {
    a="$(git rev-parse "$1")" &&
    test "$(git merge-base "$a" "$2")" = "$a"
}
if can_ff HEAD local-master/master; then
    echo can ff to local-master/master
else
    echo CAN NOT ff to local-master/master
fi

查找“后面提交”的数量

git rev-list ^HEAD upstream | wc -l

这并不要求 HEAD 可以快进到上游 （它只计算 HEAD 落后上游多远，而不计算上游落后 HEAD 多远）。

向前推进一次提交

一般来说，可快进的历史记录可能不是线性的。在下面的历史 DAG 中，master 可以快进到上游，但 A 和 B 都是从 master 上“一次提交”向上游方向前进。

---o---o                      master
       |\
       | A--o--o--o--o--o--o  upstream
        \                 /
         B---o---o---o---o

您可以像线性历史一样跟踪一侧，但只能跟踪合并提交的直接祖先。

修订行走命令有一个 --first-parent 选项，可以轻松地仅跟踪导致合并提交的第一个父级的提交。将此与 git reset 结合起来，您可以有效地“向前拖动，一次提交一个”分支。

git reset --hard "$(git rev-list --first-parent --topo-order --reverse ^HEAD upstream | head -1)"

_{在对另一个答案的评论中，您表达了对git重置的恐惧。如果您担心损坏某些分支，那么您可以使用临时分支或使用分离的 HEAD 作为未命名分支。只要你的工作树是干净的，并且你不介意移动一个分支（或分离的 HEAD）， git reset --hard 就不会丢弃任何东西。如果您仍然担心，您应该认真考虑使用git fast-export，您根本不必接触工作树。}

跟随不同的父级会更加困难。您可能必须编写自己的历史漫步者，以便您可以向其提供有关每次合并的“方向”的建议。

时，DAG 将如下所示（拓扑与之前相同，只是移动了 master 标签）：

---o---o--A--o--o--o--o--o    master
       |                  \
       |                   o  upstream
        \                 /
         B---o---o---o---o

当您向前移动到距离合并不远的点 如果你“向前推进一个提交”，你将进入合并。这也将“引入”（使 master 可以访问）从 B 到合并提交的所有提交。如果您假设“向前推进一个提交”只会向历史 DAG 添加一个提交，那么此步骤将违反该假设。

您可能需要仔细考虑在这种情况下您真正想要做什么。像这样拖入额外的提交是可以的，或者应该有某种机制可以在处理合并提交之前“返回”B 的父级并在该分支上前进？

Answer 2

如果当前提交是远程分支头的祖先，则远程分支可以快进到本地分支。换句话说，如果远程分支的“单分支历史记录”包含当前提交（因为如果包含，则可以肯定新提交已提交“到”当前提交），

因此有一种安全的方法来确定是否远程分支可以快进：

# Convert reference names to commit IDs
current_commit=$(git rev-parse HEAD)
remote_commit=$(git rev-parse remote_name/remote_branch_name)

# Call git log so that it prints only commit IDs
log=$(git log --topo-order --format='%H' $remote_commit | grep $current_commit)

# Check the existence of the current commit in the log
if [ ! -z "$log" ]
  then echo 'Remote branch can be fast-forwarded!'
fi

请注意，调用 git log 时没有使用 --all 参数（这将列出所有分支），因此当前提交不可能位于“侧分支”上并且仍打印在输出。

当前提交之前的提交数等于 $log 中 $current_commit 之前的行数。

如果您只想快进一次提交，则可以获取当前提交的前一行（例如使用 grep -B 1），并将本地分支重置为该提交。

更新：您可以使用git log commit1..commit2来确定快进提交的数量：

if [ ! -z "$log" ]
then
  # print the number of commits ahead of the current commit
  ff_commits=$(git log --topo-order --format='%H' \
    $current_commit..$remote_commit | wc -l)
  echo "Number of fast-forwarding commits: $ff_commits"

  # fast-forward only one commit
  if [ $ff_commits -gt 1 ]
  then
    next_commit=$(git log --topo-order --format='%H' \
      $current_commit..$remote_commit | tail -1)
    git reset --hard $next_commit
  fi
fi

当然，如果您保存，您可以通过一次 git log 调用来完成此操作第一次调用文件的结果。

Answer 3

这可能不是最优雅的，但它有效：

$ git fetch
$ git status | sed -n 2p
# Your branch is behind 'origin/master' by 23 commits, and can be fast-forwarded.
$ git reset origin/master~22 > /dev/null
$ git status | sed -n 2p
# Your branch is behind 'origin/master' by 22 commits, and can be fast-forwarded.