Die Ursache eines Problems im Verlauf finden

Beginnen Sie mit dem, was Sie wissen: einer Commit-Nachricht, einer Datei, einer entfernten Zeile oder einer früher funktionierenden Version. Riff bietet für jeden Hinweis einen passenden Weg und zeigt den Umfang der Suche während der Untersuchung an.

Den Graphen lesen und im Verlauf suchen

Folgen Sie den Branch- und Tag-Namen im Commit-Graphen oder zeigen Sie alle Branches, um ihre Zusammenführungen zu sehen. Wählen Sie einen Commit, um Autor, Eltern-Commits, Betreff, Beschreibung und geänderte Dateien zu prüfen. Der Verlaufsfilter durchsucht geladene Commits nach Betreff, Autor oder SHA. Die erweiterte Suche nutzt einen separaten Index auf dem Computer mit bis zu 1.000 aktuellen Commits einschließlich Nachrichtentext und liefert bis zu 500 Treffer. Sie garantiert keine Suche im gesamten Verlauf.

Mit der einheitlichen Suche navigieren

Öffnen Sie die Befehlspalette, um verfügbare Aktionen, registrierte Repositorys, lokale und entfernte Branches sowie Commits des aktiven Repositorys zu finden. Filtern Sie nach Ergebnistyp und kombinieren Sie Wörter aus Nachricht, Autor oder SHA.

Das Öffnen eines Branch- oder Commit-Ergebnisses zeigt dessen Verlauf, ohne einen Checkout auszuführen. Die Commit-Suche benötigt mindestens zwei Zeichen und umfasst die neuesten 1.000 Commits über die Referenzen des aktiven Repositorys. Pro Typ erscheinen bis zu 20 Ergebnisse; präzisieren Sie die Suche bei Erreichen der Grenze. Sie durchsucht weder sämtliche Dateien noch den vollständigen Verlauf aller Repositorys.

Den Verlauf einer Datei verfolgen

1. Öffnen Sie den Verlaufs-Explorer des aktiven Repositorys und wählen Sie die Datei. Der Dateiverlauf folgt Umbenennungen und lädt jeweils 50 Commits.
2. Wählen Sie eine Revision und prüfen Sie ihre Änderungen. Mit Blame finden Sie den für eine Zeile verantwortlichen Commit und öffnen ihn oder die vorherige Version.
3. Vergleichen Sie zwei Revisionen, um ihre Dateiänderungen zu sehen. Riff löst die Revisionen vor dem Laden in konkrete Commits auf.
4. Mit Zurück kehren Sie zur vorherigen Untersuchung zurück, einschließlich geladener Seiten, gewähltem Commit und Blame-Position.

Die Dateiauswahl zeigt bis zu 10.000 Pfade. Blame lehnt Dateien über 1 MiB, mehr als 10.000 Zeilenumbrüche oder Zeilen über 20.000 Zeichen ab. Vergleiche sind sowohl für die Summe geänderter Blobs als auch für den erzeugten Patch auf 4 MiB begrenzt; selbst eine kleine Änderung in großen Dateien kann diese Grenze überschreiten. Nicht unterstützte Inhalte erhalten einen ausdrücklichen Status.

Nach hinzugefügtem oder entferntem Text suchen

Geben Sie im Verlaufs-Explorer wörtlichen Text ein und wählen Sie einen Pfad- oder Ordnerfilter, Groß- und Kleinschreibung sowie eine Revision oder alle Referenzen. Verfolgen Sie die Anzahl untersuchter Commits und die Ergebnisse während der Suche. Öffnen Sie einen Treffer, um die Änderung zu prüfen.

Die Suche untersucht hinzugefügte und entfernte Zeilen, indem sie jeden Commit mit seinem ersten Eltern-Commit vergleicht. Sie durchsucht nicht jeden Eltern-Commit eines Merges separat. Sie endet bei 2.000 Commits oder 1.000 Treffern; übersprungene Inhalte und erreichte Grenzen kennzeichnen eine unvollständige Suche. Ihr Cache liegt im Arbeitsspeicher und ist kein dauerhafter Index des gesamten Repositorys.

Für Text in aktuellen Arbeitsdateien verwenden Sie die Dateisuche. Sie unterstützt Groß- und Kleinschreibung, ganze Wörter, reguläre Ausdrücke und optional nicht erfasste Dateien. Ergebnisse sind nach Pfad gruppiert und lassen sich im Standardeditor öffnen.

Eine Regression mit Bisect eingrenzen

1. Öffnen Sie Bisect für das Repository. Geben Sie eine bekanntermaßen funktionierende und eine fehlerhafte Revision an und prüfen Sie vor dem Start die genauen Commits.
2. Bereiten Sie einen sauberen Arbeitsbaum vor. Ausstehende Änderungen, eine andere Git-Operation oder Kollisionen mit ignorierten Dateien können den Revisionswechsel verhindern. Verschieben Sie blockierende ignorierte Dateien selbst an einen anderen Ort; sie sind keine entbehrlichen Testdaten.
3. Starten Sie die Untersuchung. Riff speichert einen Wiederherstellungspunkt und bereitet einen Kandidaten vor. Führen Sie die passende Prüfung selbst aus und markieren Sie die Revision als funktionierend, fehlerhaft oder nicht testbar.
4. Wiederholen Sie dies für den nächsten Kandidaten. Der Dialog zeigt erfasste Ergebnisse, übrige Kandidaten und das Rückkehrziel. Übersprungene Commits können mehrere mögliche Ursachen übrig lassen.
5. Beenden Sie die Untersuchung, um zum ursprünglichen Branch oder Commit zurückzukehren. Das bloße Schließen des Dialogs erhält die Sitzung; setzen Sie sie über den Hinweis im Repository fort, auch nach einem Neustart von Riff.

Bisect führt keine beliebigen Testbefehle für Sie aus. Das Intervall ist auf 100.000 Commits und die angezeigte Kandidatenliste auf 100 begrenzt. Bestehende Git-Sitzungen mit eigenen Begriffen, Pfadfiltern oder First-Parent-Modus lassen sich prüfen und beenden, werden vom geführten Ablauf aber nicht neu interpretiert.

Bereiten Sie die Korrektur als gezielten Commit vor oder prüfen Sie die Wiederherstellungspunkte, bevor Sie den Verlauf ändern.