如何从 git diff 读取输出？

Question

git-diff 的手册页相当长，并且解释了许多对初学者来说似乎不需要的情况。例如：

git diff origin/master

Answer 1

让我们看一下 git 历史中的高级差异示例（在 commit 1088261f in git.git repository 中）：

diff --git a/builtin-http-fetch.c b/http-fetch.c
similarity index 95%
rename from builtin-http-fetch.c
rename to http-fetch.c
index f3e63d7..e8f44ba 100644
--- a/builtin-http-fetch.c
+++ b/http-fetch.c
@@ -1,8 +1,9 @@
 #include "cache.h"
 #include "walker.h"
 
-int cmd_http_fetch(int argc, const char **argv, const char *prefix)
+int main(int argc, const char **argv)
 {
+       const char *prefix;
        struct walker *walker;
        int commits_on_stdin = 0;
        int commits;
@@ -18,6 +19,8 @@ int cmd_http_fetch(int argc, const char **argv, const char *prefix)
        int get_verbosely = 0;
        int get_recover = 0;
 
+       prefix = setup_git_directory();
+
        git_config(git_default_config, NULL);
 
        while (arg < argc && argv[arg][0] == '-') {

让我们逐行分析这个补丁。

• 第一行

  diff --git a/builtin-http-fetch.c b/http-fetch.c

  是diff --git a/file1 b/file2 形式的“git diff”标头。 a/ 和 b/ 文件名是相同的，除非涉及重命名/复制（如我们的例子）。 --git 表示差异是“git”差异格式。

• 接下来是一个或多个扩展标题行。前三个

  相似指数 95%
  从 builtin-http-fetch.c 重命名
  重命名为 http-fetch.c

  告诉我们文件已从 builtin-http-fetch.c 重命名为 http-fetch.c 并且这两个文件 95% 相同（用于检测此重命名）。
  
  扩展差异标头中的最后一行，即

  index f3e63d7..e8f44ba 100644

  告诉我们给定文件的模式（100644 表示它是普通文件而不是符号链接，并且它不'没有可执行权限位），以及关于 preimage（给定更改之前的文件版本）和 postimage（更改后的文件版本）的缩短哈希。 git am --3way 使用此行来尝试在无法自行应用补丁时进行 3 路合并。
  
  

• 接下来是两行统一的diff header

  --- a/builtin-http-fetch.c
  +++ b/http-fetch.c

  与 diff -U 结果相比，它在源（原像）和目标（后像）之后没有 from-file-modification-time 和 to-file-modification-time文件名。如果文件已创建，则源为/dev/null；如果文件被删除，则目标是/dev/null。
  如果您将diff.mnemonicPrefix 配置变量设置为true，则可以在此两行标题中使用a/ 和b/ 前缀代替c/ , i/, w/ 和 o/ 作为前缀，分别与您比较的内容相比；见git-config(1)

• 接下来是一大堆差异；每个大块显示文件不同的一个区域。统一格式 hunks 以行开头

  @@ -1,8 +1,9 @@

  或

  @@ -18,6 +19,8 @@ int cmd_http_fetch(int argc, const char **argv, ... 

  格式为@@ from-file-range to-file-range @@ [header]，from-file-range为-<start line>,<number of lines>，to-file-range为+<start line>,<number of lines>，start-line和number-of-lines均参考大块在原像和后像中的位置和长度，如果没有显示行数，则表示它是1。

如果是 C 文件（如 GNU diff 中的 -p 选项）或其他类型文件的等效文件（如果有），则可选标头显示每次更改发生的 C 函数。

• 接下来是文件不同之处的描述。两个文件共有的行都以空格字符开头。两个文件之间实际不同的行在左侧打印列中具有以下指示符之一：

• '+' -- 在第一个文件中添加了一行。

• '-' -- 从第一个文件中删除了一行。

例如，第一个块

     #include "cache.h"
     #include "walker.h"
     
    -int cmd_http_fetch(int argc, const char **argv, const char *prefix)
    +int main(int argc, const char **argv)
     {
    +       const char *prefix;
            struct walker *walker;
            int commits_on_stdin = 0;
            int commits;

表示cmd_http_fetch 被main 替换，并添加了const char *prefix; 这一行。

换句话说，在更改之前，'builtin-http-fetch.c' 文件的相应片段如下所示：

    #include "cache.h"
    #include "walker.h"
    
    int cmd_http_fetch(int argc, const char **argv, const char *prefix)
    {
           struct walker *walker;
           int commits_on_stdin = 0;
           int commits;

更改后，现在“http-fetch.c”文件的这个片段看起来像这样：

    #include "cache.h"
    #include "walker.h"
     
    int main(int argc, const char **argv)
    {
           const char *prefix;
           struct walker *walker;
           int commits_on_stdin = 0;
           int commits;

• 可能有

  \文件末尾没有换行符

  存在行（它不在示例差异中）。

作为Donal Fellows said，最好练习阅读现实生活中的例子的差异，在那里你知道你已经改变了什么。

参考资料：

• git-diff(1) manpage，“使用 -p 生成补丁”部分
• (diff.info)Detailed Unified 节点，“统一格式详细说明”。

Answer 2

@@ -1,2 +3,4 @@ 部分差异

这部分我花了一段时间才理解，所以我创建了一个最小的例子。

格式与diff -u统一diff基本一致。

例如：

diff -u <(seq 16) <(seq 16 | grep -Ev '^(2|3|14|15)$')

这里我们删除了第 2、3、14 和 15 行。输出：

@@ -1,6 +1,4 @@
 1
-2
-3
 4
 5
 6
@@ -11,6 +9,4 @@
 11
 12
 13
-14
-15
 16

@@ -1,6 +1,4 @@ 表示：

• -1,6 表示第一个文件的这一段从第 1 行开始，共显示 6 行。因此它显示了第 1 到第 6 行。

  1
  2
  3
  4
  5
  6
  

  - 表示“旧”，因为我们通常将其调用为diff -u old new。

• +1,4 表示第二个文件的这一段从第 1 行开始，共显示 4 行。因此它显示了第 1 到第 4 行。

  + 表示“新”。

  我们只有 4 行而不是 6 行，因为删除了 2 行！新帅只是：

  1
  4
  5
  6
  

@@ -11,6 +9,4 @@ 对于第二个大块是类似的：

• 在旧文件上，我们有 6 行，从旧文件的第 11 行开始：

  11
  12
  13
  14
  15
  16
  

• 在新文件上，我们有 4 行，从新文件的第 9 行开始：

  11
  12
  13
  16
  

  请注意，11 行是新文件的第 9 行，因为我们已经删除了前一个块上的 2 行：2 和 3。

大块头

根据您的 git 版本和配置，您还可以在 @@ 行旁边获取代码行，例如func1() { 在：

@@ -4,7 +4,6 @@ func1() {

这也可以通过普通diff 的-p 标志获得。

示例：旧文件：

func1() {
    1;
    2;
    3;
    4;
    5;
    6;
    7;
    8;
    9;
}

如果我们删除行6，差异显示：

@@ -4,7 +4,6 @@ func1() {
     3;
     4;
     5;
-    6;
     7;
     8;
     9;

请注意，这不是func1 的正确行：它跳过了1 和2 行。

这个很棒的功能通常可以准确地告诉每个块属于哪个函数或类，这对于解释差异非常有用。

选择标头的算法如何准确地工作在：Where does the excerpt in the git diff hunk header come from?

Answer 3

这是一个简单的例子。

diff --git a/file b/file 
index 10ff2df..84d4fa2 100644
--- a/file
+++ b/file
@@ -1,5 +1,5 @@
 line1
 line2
-this line will be deleted
 line4
 line5
+this line is added

这里有一个解释：

• --git 不是命令，这意味着它是 git 版本的 diff（不是 unix）
• a/ b/ 是目录，它们不是真实的。当我们处理同一个文件时，这只是一种方便（在我的情况下，a/ 在索引中，b/ 在工作目录中）
• 10ff2df..84d4fa2 是这两个文件的 blob ID
• 100644 是“模式位”，表示这是一个常规文件（不可执行且不是符号链接）
• --- a/file +++ b/file 减号显示 a/ 版本中的行，但 b/ 版本中缺少；加号表示 a/ 中缺少但 b/ 中存在的行（在我的情况下 --- 表示已删除的行，+++ 表示 b/ 中添加的行，这是工作目录中的文件）
• @@ -1,5 +1,5 @@ 为了理解这一点，最好使用大文件；如果您在不同的地方有两个更改，您将获得两个条目，例如@@ -1,5 +1,5 @@；假设你有文件 line1 ... line100 并删除了 line10 并添加了新的 line100 - 你会得到：

@@ -7,7 +7,6 @@ line6
 line7
 line8
 line9
-this line10 to be deleted
 line11
 line12
 line13
@@ -98,3 +97,4 @@ line97
 line98
 line99
 line100
+this is new line100

Answer 4

默认输出格式（如果您想查找更多信息，它最初来自称为diff 的程序）称为“统一差异”。它基本上包含 4 种不同类型的线条：

• 上下文行，以单个空格开头，
• 插入行显示已插入的行，以+ 开头，
• 删除行，以- 开头，并且
• 描述更高级别内容的元数据行，例如正在讨论的文件、用于生成差异的选项、文件是否更改了权限等。

我建议您练习阅读文件的两个版本之间的差异，您可以确切地知道您所做的更改。这样，当您看到它时，您就会知道发生了什么。

Answer 5

在我的 Mac 上：

info diff 然后选择：Output formats -> Context -> Unified format -> Detailed Unified ：

或online man diff 在 gnu 上遵循相同路径到相同部分：

文件：diff.info，节点：详细 统一，下一个：示例统一，上： 统一格式

统一格式详细说明 ....................................

统一输出格式开始 带有两行标题，看起来 像这样：

 --- FROM-FILE FROM-FILE-MODIFICATION-TIME
 +++ TO-FILE TO-FILE-MODIFICATION-TIME

时间戳看起来像`2002-02-21 23:30:39.942229878 -0800' 表示 带小数的日期、时间 秒和时区。

您可以更改标题的内容 使用 `--label=LABEL' 选项；看 *注意别名::.

接下来是一大群人 差异；每个大块显示一个区域 文件不同的地方。统一 格式帅哥是这样的：

 @@ FROM-FILE-RANGE TO-FILE-RANGE @@
  LINE-FROM-EITHER-FILE
  LINE-FROM-EITHER-FILE...

两个文件共有的行 以空格字符开头。这 实际上不同的线 两个文件具有以下之一 左侧打印中的指示字符 专栏：

`+' 此处向第一个文件添加了一行。

`-' 此处从第一个文件中删除了一行。

Answer 6

从您的问题中不清楚您对差异的哪一部分感到困惑：实际差异或 git 打印的额外标题信息。以防万一，这里是标题的快速概述。

第一行类似于diff --git a/path/to/file b/path/to/file - 显然它只是告诉您这部分差异用于哪个文件。如果您设置布尔配置变量diff.mnemonic prefix，a 和b 将更改为更具描述性的字母，例如c 和w（提交和工作树）。

接下来，有“模式行”——这些行为您提供不涉及更改文件内容的任何更改的描述。这包括新的/删除的文件、重命名/复制的文件和权限更改。

最后，有一行像index 789bd4..0afb621 100644。您可能永远不会关心它，但那些 6 位十六进制数字是该文件的旧 blob 和新 blob 的缩写 SHA1 哈希（blob 是一个 git 对象，用于存储文件内容等原始数据）。当然，100644 是文件的模式——最后三位显然是权限；前三个提供额外的文件元数据信息 (SO post describing that)。

之后，您将使用标准的统一差异输出（就像经典的 diff -U 一样）。它被分成大块 - 大块是包含更改及其上下文的文件的一部分。每个块前面都有一对 --- 和 +++ 行，表示有问题的文件，然后实际差异是（默认情况下）- 和 + 行两侧的三行上下文，显示删除/添加行。