Git show vs Git log --numstat 输出差异

Question

我正在比较具有相同选项的 git show 和 git log。我在不同的提交上得到不同的结果。我还没有真正深入研究文档来弄清楚这是为什么，但我猜这与每个命令如何解释修订列表以及提交图的样子有关？例如，FFmpeg 上的演示:

案例一git日志:

> git log -n1 --numstat --format='%H' 00049f193d07cec0409069bc51d0dcb8ab9da837
00049f193d07cec0409069bc51d0dcb8ab9da837

案例一git show:

> git show -n1 --numstat --format='%H' 00049f193d07cec0409069bc51d0dcb8ab9da837
00049f193d07cec0409069bc51d0dcb8ab9da837

4       0       libavcodec/mpegaudiodecheader.c

案例2 git日志:

> git log -n1 --numstat --format='%H' 001d668d40b5f87d19271c7d5521368b5187425b
001d668d40b5f87d19271c7d5521368b5187425b

2       5       libavformat/dvenc.c
2       6       libavformat/gxfenc.c
5       0       libavformat/internal.h
2       5       libavformat/movenc.c
2       5       libavformat/mxfenc.c
7       0       libavformat/utils.c

案例2 git show:

> git show -n1 --numstat --format='%H' 001d668d40b5f87d19271c7d5521368b5187425b
001d668d40b5f87d19271c7d5521368b5187425b

2       5       libavformat/dvenc.c
2       6       libavformat/gxfenc.c
5       0       libavformat/internal.h
2       5       libavformat/movenc.c
2       5       libavformat/mxfenc.c
7       0       libavformat/utils.c

基本上，我很困惑为什么在情况 1 中，log 省略了更改的文件 (libavcodec/mpegaaudiodecheader.c)，而 show 包括它们，然后在情况 2 中，输出是相同。

供引用:

> git diff --numstat 00049f193d07cec0409069bc51d0dcb8ab9da837 00049f193d07cec0409069bc51d0dcb8ab9da837^
0       4       libavcodec/mpegaudiodecheader.c

Answer 1

Joseph K. Strauss's answer是正确的(这是一个 merge 提交)但不是很完整。缺失的信息散布在 Git 文档和源代码中，这就是为什么它们很难找到的原因。

首先，00049f193d07cec0409069bc51d0dcb8ab9da837 really is a merge commit .它的两个父节点是 d832020bd853f84b96a3fdf3e0a385d8492ec8c8 和 fcbcc561e0fdc95a7dd48b92db53846726aec27e(我们不需要知道它们的确切数字，但不妨记录它们以显示其“merge 性”)。

The git show documentation给了我们一个提示:

Any diff-generating command can take the -c or --cc option to produce a combined diff when showing a merge. This is the default format when showing merges with git-diff(1) or git-show(1). Note also that you can give the -m option to any of these commands to force generation of diffs with individual parents of a merge.

这里缺少的是对 -c 和 --cc 本身的描述，这在两个链接的手册页中都找不到，但是 < em>是在那git diff-tree .然而，在我们去那里之前，值得去 the git diff documentation ，我们在哪里找到这个:

"git-diff-tree", "git-diff-files" and "git-diff --raw" can take -c or --cc option to generate diff output also for merge commits. [snip example]
Note that combined diff lists only files which were modified from all parents.

(我的粗体，但它确实非常重要；我们稍后会再次看到它，我将再次使用粗体)。现在我们可以跳回到git diff-tree ，我们在其中找到了 -c 和 --cc 的实际描述:

-c
      This flag changes the way a merge commit is displayed (which means it is useful only when the command is given one tree-ish, or --stdin). It shows the differences from each of the parents to the merge result simultaneously instead of showing pairwise diff between a parent and the result one at a time (which is what the -m option does). Furthermore, it lists only files which were modified from all parents.

--cc
      This flag changes the way a merge commit patch is displayed, in a similar way to the -c option. It implies the -c and -p options and further compresses the patch output by omitting uninteresting hunks whose the contents in the parents have only two variants and the merge result picks one of them without modification. When all hunks are uninteresting, the commit itself and the commit log message is not shown, just like in any other "empty diff" case.

请注意，这告诉我们 --cc 是 git show 的默认值，但没有说明 git log。事实证明，git log 默认只完全抑制 merge 差异输出，而 git show 设置 --cc。前者似乎没有在任何地方记录，但可以在 Git 源代码中找到，在 builtin/log.c 和 revision.c 中:

[revision.c]
void init_revisions(struct rev_info *revs, const char *prefix)
{
        memset(revs, 0, sizeof(*revs));

        revs->abbrev = DEFAULT_ABBREV;
        revs->ignore_merges = 1;
        revs->simplify_history = 1;
[snip]

这为所有命令设置了忽略 merge 的默认操作(revs->ignore_merges = 1)；想要处理 merge 的命令需要清除标志(这也在 Documentation/technical/api-revision-walking.txt 中注明)。

git show 和 git log(以及其他几个)都在 builtin/log.c 中实现，其中包含这个，在部分:

static void log_setup_revisions_tweak(struct rev_info *rev,
                                      struct setup_revision_opt *opt)
{
        if (DIFF_OPT_TST(&rev->diffopt, DEFAULT_FOLLOW_RENAMES) &&
            rev->prune_data.nr == 1)
                DIFF_OPT_SET(&rev->diffopt, FOLLOW_RENAMES);

        /* Turn --cc/-c into -p --cc/-c when -p was not given */
        if (!rev->diffopt.output_format && rev->combine_merges)
                rev->diffopt.output_format = DIFF_FORMAT_PATCH;

        /* Turn -m on when --cc/-c was given */
        if (rev->combine_merges)
                rev->ignore_merges = 0;
}

这是组合差异选项的地方，如果选择，则完全可以显示 merge 。同时，对于 git show:

static void show_setup_revisions_tweak(struct rev_info *rev,
                                       struct setup_revision_opt *opt)
{
        if (rev->ignore_merges) {
                /* There was no "-m" on the command line */
                rev->ignore_merges = 0;
                if (!rev->first_parent_only && !rev->combine_merges) {
                        /* No "--first-parent", "-c", or "--cc" */
                        rev->combine_merges = 1;
                        rev->dense_combined_merges = 1;
                }
        }
        if (!rev->diffopt.output_format)
                rev->diffopt.output_format = DIFF_FORMAT_PATCH;
}

因此 git show 检查是否指定了 -m。如果没有，它会在内部打开 -m，然后打开 --cc 除非有以下三个显式选项中的任何一个:-c、--cc 和 --first-parent。前两个有意义(不要覆盖用户的设置)但第三个很奇怪。 (也许它是为了避免以后引起问题，例如，如果我们要进行组合差异但只抽取了一个父 ID。)

仍然不是很明显的是这些不同的原因:

$ git log --no-walk --numstat 00049f193d07cec0409069bc51d0dcb8ab9da837 
[snip output: log message, with no diff-stats]
$ git show --numstat 00049f193d07cec0409069bc51d0dcb8ab9da837
[snip log message]
4       0       libavcodec/mpegaudiodecheader.c

如果我们简单地将 -m 添加到 git log(以便我们清除 rev->ignore_merges 标志)，我们会得到 numstat 差异 parent 双方。但是，如果我们也添加 --cc，我们会得到与 git show 相同的结果:

$ git log -m --cc --no-walk --numstat 00049f193d07cec0409069bc51d0dcb8ab9da837
[snip log message]
4       0       libavcodec/mpegaudiodecheader.c

稍加思考现在就清楚了为什么我们只看到一个文件:这是唯一一个从两个父文件都有更改的文件。这是相同的约束至于任何组合差异，果然，将 --cc 替换为 -c(使用相同的 git log)会产生相同的结果。

归根结底

如果没有 -m、-c 或 --cc，git log 会打印 merge 日志消息，但从未尝试显示 merge 提交与其父项的差异。没有任何这些选项，git show 设置 --cc。这大约有一半记录在案。