Was sind die Unterschiede zwischen Doppelpunkt ".." und Dreifachpunkt "..." in Git Diff Commit-Bereichen?

Was sind die Unterschiede zwischen den folgenden Befehlen?:

git diff foo master   # a 
git diff foo..master  # b
git diff foo...master # c

Das Diff-Handbuch spricht darüber:

Branchen vergleichen

$ git diff topic master    <1>
$ git diff topic..master   <2>
$ git diff topic...master  <3>

1. Änderungen zwischen den Tipps des Themas und den Hauptzweigen.
2. Das gleiche wie oben.
3. Änderungen, die seit dem Start des Themenzweigs im Hauptzweig aufgetreten sind.

ist mir aber nicht ganz klar.

Da ich diese Bilder bereits erstellt hatte, dachte ich, dass es sich lohnen könnte, sie in einer anderen Antwort zu verwenden, obwohl die Beschreibung des Unterschieds zwischen ..(Punkt-Punkt) und ...(Punkt-Punkt-Punkt) im Wesentlichen dieselbe ist wie in der Antwort von manojlds .

Der git diffBefehl¹ zeigt normalerweise nur den Unterschied zwischen den Zuständen des Baums zwischen genau zwei Punkten im Festschreibungsdiagramm an. Die ..und ...Notationen in git diffhaben folgende Bedeutung:

Mit anderen Worten, git diff foo..barist genau das gleiche wie git diff foo bar; beide zeigen Ihnen den Unterschied zwischen den Spitzen der beiden Zweige foound bar. Auf der anderen Seite git diff foo...barwird Ihnen der Unterschied zwischen der "Zusammenführungsbasis" der beiden Zweige und der Spitze von angezeigt bar. Die "Zusammenführungsbasis" ist normalerweise das letzte gemeinsame Commit zwischen diesen beiden Zweigen. Dieser Befehl zeigt Ihnen also die Änderungen an, an denen Ihre Arbeit vorgenommen barhat, und ignoriert alles, was fooin der Zwischenzeit vorgenommen wurde.

Das ist alles, was Sie über die ..und ...Notationen in wissen müssen git diff. Jedoch...

... eine häufige Quelle der Verwirrung ist, dass ..und ...bedeutet subtil unterschiedliche Dinge, wenn sie in einem Befehl verwendet werden git log, der eine Reihe von Commits als ein oder mehrere Argumente erwartet. (Diese Befehle werden alle verwendet git rev-list, um eine Liste von Commits anhand ihrer Argumente zu analysieren.)

Die Bedeutung von ..und ...für git logkann wie folgt grafisch dargestellt werden:

So git rev-list foo..barzeigt Ihnen alles , was auf dem Zweig bar, der nicht auch auf einem Ast ist foo. git rev-list foo...barZeigt Ihnen andererseits alle Commits an, die in einem foo oder bar , aber nicht in beiden enthalten sind . Das dritte Diagramm zeigt nur, dass Sie, wenn Sie die beiden Zweige auflisten, die Commits erhalten, die sich in einem oder beiden befinden.

Nun, ich finde das sowieso alles ein bisschen verwirrend und ich denke, die Commit-Diagramme helfen :)

¹ Ich sage nur "typisch", da beim Lösen von Zusammenführungskonflikten beispielsweise git diffeine Drei-Wege-Zusammenführung angezeigt wird.

Meine konsolidierte Version des .. vs ... mit diff vs log

git diff foo master Unterschied zwischen den obersten (Kopf-) Commits von foo und master.

git diff foo..master Eine andere Art, dasselbe zu tun.

git diff foo...masterUnterscheiden Sie sich vom gemeinsamen Vorfahren ( git merge-base foo master) von foo und master bis zur Spitze des Masters. Mit anderen Worten, zeigt nur die Änderungen an, die der Hauptzweig seit seinem gemeinsamen Vorfahren mit foo vorgenommen hat.

In diesem Beispiel von GitHub wird erklärt, wann die beiden zu verwenden sind:

Wenn Sie beispielsweise einen 'dev'-Zweig erstellen und einer Datei eine Funktion hinzufügen, kehren Sie zu Ihrem' master'-Zweig zurück, entfernen Sie eine Zeile aus der README-Datei und führen Sie Folgendes aus:

$ git diff master dev

Hier erfahren Sie, dass eine Funktion aus der ersten Datei hinzugefügt und der README eine Zeile hinzugefügt wurde. Warum? Da in der Verzweigung die README-Datei immer noch die ursprüngliche Zeile enthält, Sie sie jedoch in 'master' entfernt haben. Wenn Sie also die Snapshots direkt vergleichen, sieht es so aus, als hätte 'dev' sie hinzugefügt.

Was Sie wirklich vergleichen möchten, ist, was sich 'dev' geändert hat, seit Ihre Zweige auseinander gegangen sind. Dazu hat Git eine nette kleine Abkürzung:

$ git diff master...dev

git diff foo master

zeigt die Unterschiede zwischen dem Thema und dem Hauptzweig zu diesem Zeitpunkt

git diff foo..master

Dies zeigt auch die Unterschiede zwischen dem Thema und dem Hauptzweig zu diesem Zeitpunkt

git diff foo...master

Dies zeigt alle Unterschiede zwischen dem Zeitpunkt, zu dem das Thema aus dem Zweig erstellt wurde, und danach

Die ersten beiden Befehle sind also gleich und der letzte zeigt nur eine breitere Ansicht im Diff-Verlauf

Das obere Bild entspricht dem unteren Diagrammbaum

A0 <- A1 <- A2 <- A3 (master)
   \
    C0 <- C1 (test)

Ein Bild sagt mehr als tausend Worte, der Unterschied zwischen .. ... ^ist unten dargestellt.

$ git log master..test
# output C0 C1

$ git log ^master test
# output C0 C1

$ git log master…test
# output A1 A2 A3 C0 C1