Wie verfolgt Git den Verlauf während eines Refactorings?

Question

Ich verstehe gut, wie Git Dateibewegungen unterstützen kann: da es Datei-Hash verwendet, wird eine "hinzugefügte" Datei leicht als die "entfernte" Datei erkannt.

Meine Frage ist über Refactoring: unter Berücksichtigung von Java ändert sich die Paketdeklaration, so dass der Inhalt der Datei nicht identisch sein wird. Wie bestimmt Git in diesem Fall, dass die "hinzugefügte" Datei den Verlauf mit dem "entfernten" teilt? Wird nach "ähnlichstem Inhalt" gesucht, vorausgesetzt, ich habe nur geringfügige Änderungen oder ähnliche nichtdeterministische Lösungen vorgenommen?

Answer 1

Wie in Git FAQ erwähnt, wird es ähnliche Inhalte basierend auf einer Heuristik erkennen.

Git muss mit vielen verschiedenen Workflows zusammenarbeiten, z. B. können einige Änderungen von Patches stammen, bei denen Umbenennungsinformationen möglicherweise nicht verfügbar sind. Sich auf das explizite Umbenennungs-Tracking zu verlassen, macht es unmöglich, zwei Bäume zusammenzuführen, die genau das Gleiche gemacht haben, außer einem als Patch (create/delete) und einmal mit einer anderen Heuristik.

Eine zweite Anmerkung, Tracking-Umbenennungen ist wirklich nur ein Spezialfall der Verfolgung, wie sich Inhalte in der Struktur bewegen. In einigen Fällen sind Sie möglicherweise an einer Abfrage interessiert, wenn eine Funktion hinzugefügt oder in eine andere Datei verschoben wurde. Indem es sich nur auf die Fähigkeit stützt, diese Informationen bei Bedarf neu zu erstellen, zielt Git darauf ab, eine flexiblere Möglichkeit zu bieten, um zu verfolgen, wie sich Ihr Baum verändert.

Dies bedeutet jedoch nicht, dass Git keine Umbenennungen unterstützt.
Die Diff-Maschine in Git unterstützt die automatische Erkennung von Umbenennungen. Dies wird durch den Schalter '-M' in die Befehlsfamilie git-diff-* aktiviert.
Die Umbenennungserkennungsmaschinerie wird von git-log (1) und git-whatchanged (1) verwendet, so dass zum Beispiel 'git log -M' den Commit-Verlauf mit Umbenennungsinformationen angibt.
Git unterstützt auch eine eingeschränkte Form der Zusammenführung von Umbenennungen.
Die beiden Tools zum Zuweisen von Schuldzuweisungen, git-blame(1) und git-annotate(1), verwenden beide den automatischen Umbenennungs-Erkennungscode, um Umbenennungen zu verfolgen.

---

git log gibt Ihnen einige Details über diese Heuristik:

-B[<n>][/<m>] 

Pause komplett neu geschrieben Änderungen in Lösch- und erstellen. Dies dient zwei Zwecken:

• Es die Art und Weise eine Änderung wirkt sich das aus einer Datei nicht als eine Reihe von Löschen und Einfügen zusammen gemischt mit sehr wenigen Linien auf insgesamt Rewrite Beträge, die textlich als Kontext anzupassen passieren , aber als eine einzige Löschung von allem alt gefolgt von einer einzigen Einfügung von allem neu, und die Zahl m steuert diesen Aspekt der -B Option (standardmäßig 60%).
  -B/70% gibt an, dass weniger als 30% des Originals im Ergebnis bleiben sollten, damit git es als vollständig umgeschrieben betrachtet (dh andernfalls wird der resultierende Patch eine Reihe von Lösch- und Einfügemischungen zusammen mit Kontextlinien sein)).

• Bei der Verwendung mit -M wird eine vollständig neu geschriebene Datei ebenfalls als Quelle für eine Umbenennung angesehen (normalerweise betrachtet -M nur eine Datei, die als Quelle einer Umbenennung verschwindet), und die Zahl n steuert diesen Aspekt der -B Option (standardmäßig 50%).
  -B20% gibt an, dass eine Änderung mit Hinzufügung und Löschung im Vergleich zu 20% oder mehr der Dateigröße als mögliche Quelle für eine Umbenennung in eine andere Datei ausgewählt werden kann.

-M[<n>] 

Wenn diffs zu erzeugen, erkennen und Bericht für jede umbenennt begehen. Weitere Informationen zum Umbenennen von Dateien finden Sie unter --follow.
Wenn n angegeben ist, ist a ein Schwellenwert für den Ähnlichkeitsindex (d. H. Menge an Hinzufügungen/Löschungen im Vergleich zur Dateigröße).
Zum Beispiel bedeutet -M90%, dass git ein Lösch/hinzufügen-Paar als Umbenennung betrachten sollte, wenn mehr als 90% der Datei nicht geändert wurden.

---

Weitere Referenzen:

• Linus's ultimate content tracking tool blog post, von Junio ​​C Hamano, Maintainer von Git.
• Getting Git to Acknowledge Previously Moved Files
• How to make git mark a deleted and a new file as a file move?
• How does Git solve the merging problem?