git：以编程方式了解分支领先/落后远程分支多少

Question

我想提取 git status 之后打印的信息，如下所示：

# On branch master
# Your branch is ahead of 'origin/master' by 2 commits.

当然我可以解析 git status 的输出，但不建议这样做，因为这人类可读的输出很容易改变。

这里有两个问题：

1. 如何知道远程跟踪的分支？它通常是起源/分支，但不一定是。
2. 如何获取数字？如何知道是否领先/落后？通过多少次提交？那么分歧分支的情况又如何呢？

Answer 1

git rev-list origin..HEAD 将显示当前分支中的提交，但不显示 origin 的提交——即，您是否领先于 origin 以及哪些提交。

git rev-list HEAD..origin 将显示相反的情况。

如果两个命令都显示提交，则说明您有分歧的分支。

Answer 2

更新

正如 amalloy 所指出的，最新版本的 git 支持通过给出“branchname@{upstream}”（或“branchname@{u}”或“@”来查找给定分支的匹配跟踪分支） {u}”用于 HEAD 的跟踪分支）。这有效地取代了下面的脚本。你可以这样做：

git rev-list @{u}..
git rev-list --left-right --boundary @{u}...
gitk @{u}...

等等。例如，我将 git q 别名为 git log --pretty='...' @{u}.. 来向我展示“已排队”提交准备好推送。

原始答案

一般情况下，似乎没有一种简单的方法可以找到跟踪分支，而无需解析比一些 shell 命令中实用的更多的 git 配置。但对于许多情况，这将大有帮助：

# work out the current branch name
currentbranch=$(expr $(git symbolic-ref HEAD) : 'refs/heads/\(.*\)')
[ -n "$currentbranch" ] || die "You don't seem to be on a branch"
# look up this branch in the configuration
remote=$(git config branch.$currentbranch.remote)
remote_ref=$(git config branch.$currentbranch.merge)
# convert the remote ref into the tracking ref... this is a hack
remote_branch=$(expr $remote_ref : 'refs/heads/\(.*\)')
tracking_branch=refs/remotes/$remote/$remote_branch
# now $tracking_branch should be the local ref tracking HEAD
git rev-list $tracking_branch..HEAD

另一种更暴力的方法：

git rev-list HEAD --not --remotes

jamessan 的答案解释了如何使用 git rev-list 找到 $tracking_branch 和 HEAD 之间的相对差异。您可以做一件有趣的事情：（

git rev-list --left-right $tracking_branch...HEAD

注意 $tracking_branch 和 HEAD 之间的三个点）。这将显示两个“手臂”上的提交，并在前面有一个区分标记：“<”对于 $tracking_branch 上的提交，以及“>”用于 HEAD 上的提交。

Answer 3

您可以尝试gitbranch -v -v。使用 -v 标志给出两次，它会输出上游分支的名称。示例输出：

* devel  7a5ff2c [origin/devel: ahead 1] smaller file status overlay icons
  master 37ca389 [origin/master] initial project check-in.

我认为这种格式比 git status 输出更稳定。

Answer 4

在现代版本的 git 中，@{u} 指向当前分支的上游（如果已设置）。

因此，要计算您在远程跟踪分支后面的提交次数：

git rev-list --count HEAD..@{u}

并查看您领先远程分支的距离，只需切换顺序：

git rev-list --count @{u}..HEAD

为了获得更易读的摘要，您可以要求提供日志：

git log --pretty=oneline @{u}..HEAD

对于我自己的出于目的，我正在编写一个脚本，如果尚未设置上游，该脚本将用适当的猜测替换 @{u} 。不幸的是，目前没有 @{d} 来代表下游（您将推送到的位置）。

Answer 5

编辑：
我原来的答案实际上不是很好，因为它依赖于用户拥有一个名为“origin”的遥控器。如果当前分支除了 origin-head 之外还有跟踪分支，它也会失败。这些缺陷基本上使其毫无用处。然而，@araqnid 的答案并不是最有效的方法，而且他到达 $tracking_branch 的方式也不是直线前进。我发现获得相同功能的最有效（最快）的方法如下：

# get the tracking-branch name
tracking_branch=$(git for-each-ref --format='%(upstream:short)' $(git symbolic-ref -q HEAD))
# creates global variables $1 and $2 based on left vs. right tracking
# inspired by @adam_spiers
set -- $(git rev-list --left-right --count $tracking_branch...HEAD)
behind=$1
ahead=$2

---

原始答案：（较差，但为了清楚起见而给出）

也许是我能找到的最简单的方法（受到@insidepower的启发）

# count the number of logs
behind=$(git log --oneline HEAD..origin | wc -l)
ahead=$( git log --oneline origin..HEAD | wc -l)

我以前一直在使用该方法@araqnid，但现在我想我会将一些脚本移至此方法，因为它要简单得多。这应该适用于任何 UNIX 系统。

Answer 6

git status 有一个 --porcelain 选项，用于通过脚本进行解析。它基于 --short 输出 - 它们在撰写本文时几乎相同（请参阅 git status 手册页 了解详细信息）。主要区别在于 --short 具有颜色输出。

默认情况下，不显示分支信息，但如果添加 --branch 选项，您将得到如下输出：

git status --short --branch
## master...origin/master [ahead 1]
?? untrackedfile.txt
...

如果您是最新的（在获取之后），则分支行将是：

## master

如果你领先：

## master...origin/master [ahead 1]

如果你落后：

## master...origin/master [behind 58]

对于两者：

## master...origin/master [ahead 1, behind 58]

请注意， git status --porcelain --branch 仅在 1.7.10.3 或更高版本（尽管 git status --short --branch 已可用自 1.7.2 开始。

Answer 7

为什么这不起作用：

#!/bin/sh
git diff origin/master..HEAD --quiet --exit-code
RETVAL=$?
if [ $RETVAL -gt 0 ]; then
    echo "You need to git push!"
else
    echo "No git push necessary!"
fi 

Answer 8

araqnid 的答案中最上面的代码块对我来说不起作用，所以也许 git 中的某些内容自 18 个月前编写以来已经发生了变化。如果我更改为：

tracking_branch=refs/remotes/$remote/$remote_branch

但是

tracking_branch=$remote/$remote_branch

跟踪本地分支时仍然存在问题，在这种情况下，您必须修剪远程部分（变成“。”）：

tracking_branch=${tracking_branch#./}

然后您可以以编程方式获取前后的修订数量，如下所示如下：

set -- `git rev-list --left-right --count $tracking_branch...HEAD`
behind="$1"
ahead="$2"

我已经编写了脚本来完成所有这些操作（以及更多 - 例如，他们还可以尝试在 git-svn 桥的另一侧发现遥控器），并将它们发布在 git-svn">）。 com/aspiers/git-config#readme" rel="nofollow">我在 github 上的 git-config 存储库。例如，这是我的 git-compare-upstream。有关安装说明和其他方便的相关脚本，请参阅自述文件。

Answer 9

如何知道远程跟踪的分支？它通常是起源/分支，但不一定是。

Git 2.5+ 引入了一个新的快捷方式，它引用您要推送到的分支。 @{push}：这将是这里感兴趣的远程跟踪分支。

这意味着您有另一个选项可以查看配置为推送到分支的所有分支的前方/后方。

git for-each-ref --format="%(push:track)" refs/heads

请参阅“查看未推送的 Git 提交”了解更多信息

Answer 10

对于最新版本的 git，您应该使用

git status --porcelain --branch

并检查前方/后方：

## master...origin/master [behind 1]

--瓷器[=版本]

以易于解析的脚本格式提供输出。这与短输出类似，但在不同的 Git 版本中都保持稳定，无论
用户配置。详情请参阅下文。

-b，--分支

即使以短格式显示分支和跟踪信息。