O que “@@ -1 +1 @@” significa na saída de diff do Git?

Tenho coletado dados das informações retornadas de

git diff <commitId>..<commitId>

e eu corri para @@ -1 +1 @@

Não consigo descobrir o que isso está me dizendo. Pesquisei um pouco no Google, mas não adiantou.

É um identificador de bloco diff unificado. Isso é documentado pelo GNU Diffutils.

O formato de saída unificado começa com um cabeçalho de duas linhas, que se parece com isto:

--- from-file from-file-mod-time 
+++ para-file to-file-mod-time-time

O carimbo de hora parece 2002-02-21 23:30:39.942229878 -0800indicar a data, hora com segundos fracionários e fuso horário. Os segundos fracionários são omitidos em hosts que não oferecem suporte a carimbos de data / hora fracionários.

Você pode alterar o conteúdo do cabeçalho com a --label=labelopção; consulte Ver nomes alternativos .

Em seguida, vêm um ou mais blocos de diferenças; cada pedaço mostra uma área onde os arquivos são diferentes. Os pedaços de formato unificado são assim:

@@ números-de-linha-de-arquivo-para-arquivo-números -de-linha
  @@-
  linha-de-qualquer-arquivo -linha-de-qualquer-arquivo ...

Se um pedaço contém apenas uma linha, apenas o número da linha inicial aparece. Caso contrário, seus números de linha serão semelhantes . Um pedaço vazio é considerado como começando na linha que segue o pedaço.start,count

Se um pedaço e seu contexto contiverem duas ou mais linhas, seus números de linha serão semelhantes . Caso contrário, apenas o número da linha final aparece. Um pedaço vazio é considerado como terminando na linha que precede o pedaço.start,count

As linhas comuns a ambos os arquivos começam com um caractere de espaço. As linhas que realmente diferem entre os dois arquivos têm um dos seguintes caracteres indicadores na coluna de impressão à esquerda:

• +
  Uma linha foi adicionada aqui ao primeiro arquivo.
• -
  Uma linha foi removida aqui do primeiro arquivo.

Análise de exemplo simples

O formato é basicamente o mesmo do diff -udiff unificado.

Por exemplo:

diff -u <(seq -w 16) <(seq -w 16 | grep -Ev '^(02|03|14|15)$')

Aqui removemos as linhas 2, 3, 14 e 15. Resultado:

@@ -1,6 +1,4 @@
 01
-02
-03
 04
 05
 06
@@ -11,6 +9,4 @@
 11
 12
 13
-14
-15
 16

@@ -1,6 +1,4 @@ significa:

• -1,6significa que esta parte do primeiro arquivo começa na linha 1 e mostra um total de 6 linhas. Portanto, mostra as linhas 1 a 6.

  1
  2
  3
  4
  5
  6
  

  -significa "antigo", como normalmente o chamamos diff -u old new.

• +1,4significa que esta parte do segundo arquivo começa na linha 1 e mostra um total de 4 linhas. Portanto, ele mostra as linhas 1 a 4.

  + significa "novo".

  Temos apenas 4 linhas em vez de 6 porque 2 linhas foram removidas! O novo pedaço é apenas:

  01
  04
  05
  06
  

@@ -11,6 +9,4 @@ pois o segundo pedaço é análogo:

• no arquivo antigo, temos 6 linhas, começando na linha 11 do arquivo antigo:

  11
  12
  13
  14
  15
  16
  

• no novo arquivo, temos 4 linhas, começando na linha 9 do novo arquivo:

  11
  12
  13
  16
  

  Observe que a linha 11é a 9ª linha do novo arquivo porque já removemos 2 linhas no trecho anterior: 2 e 3.

Cabeçalho Hunk

Dependendo da sua versão e configuração do git, você também pode obter uma linha de código ao lado da @@linha, por exemplo, func1() {em:

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

Isso também pode ser obtido com a -pbandeira da planície diff.

Exemplo: arquivo antigo:

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

Se removermos a linha 6, o diff mostra:

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

Observe que esta não é a linha correta para func1: ela pulou linhas 1e 2.

Esse recurso incrível geralmente diz exatamente a qual função ou classe cada pedaço pertence, o que é muito útil para interpretar o diff.

Como o algoritmo para escolher o cabeçalho funciona exatamente é discutido em: De onde vem o trecho no cabeçalho git diff hunk?

É a informação do intervalo do pedaço atual que indica em quais números de linha esse pedaço diff começa e termina.

Leia http://en.wikipedia.org/wiki/Diff#Unified_format para obter uma explicação detalhada.