Branches

Verwenden Sie Verzweigungen in GitHub, um Entwicklungsarbeit zu isolieren, Standardverzweigungen zu verwalten und effektiv mithilfe von Pullanforderungen und Verzweigungsschutz zusammenzuarbeiten.

In diesem Artikel

Informationen zu Branches

Mit Branches können Sie Features entwickeln, Fehler beheben oder sicher mit neuen Ideen in einem enthaltenen Bereich Ihres Repositorys experimentieren.

Du erstellst einen Zweig immer aus einem existierenden Zweig. Normalerweise würdest du einen neuen Branch aus dem Standardbranch deines Repositorys erstellen. Dann kannst du an diesem neuen Zweig unabhängig von Änderungen arbeiten, die von anderen Personen im Repository vorgenommen werden.

Eine Verzweigung, die Sie zum Erstellen eines Features erstellen, wird häufig als Featurezweig oder Themenzweig bezeichnet. Siehe Managing branches within your repository.

Sie können auch eine Verzweigung verwenden, um eine GitHub Pages Website zu veröffentlichen. Siehe Was ist GitHub Pages?.

Du benötigst Schreibzugriff auf ein Repository, um einen Branch zu erstellen, einen Pull Request zu öffnen oder Branches in einem Pull Request zu löschen und wiederherzustellen. Siehe Zugriffsberechtigungen für GitHub.

Informationen zum Standard-Branch

Wenn du ein Repository mit Inhalten auf GitHub erstellst, erstellt GitHub das Repository mit einem einzelnen Branch. Dieser erste Branch im Repository ist der Standardbranch. Die Standardverzweigung ist die Verzweigung, die GitHub angezeigt wird, wenn jemand Ihr Repository besucht. Der Standardbranch ist auch der erste Branch, den Git lokal auscheckt, wenn jemand das Repository klont. Sofern du keinen anderen Branch angibst, ist der Standardbranch in einem Repository der Basisbranch für neue Pull Requests und Codecommits.

Benennt standardmäßig GitHub den Standardverzweigung main in einem beliebigen neuen Repository.

Du kannst den Standardbranch für ein vorhandenes Repository ändern. Weitere Informationen finden Sie unter Ändern des Standardbranchs.

Du kannst den Namen des Standardzweigs für neue Repositories festlegen. Weitere Informationen findest du unter Verwalten des Standardbranchnamens für deine Repositorys, Verwalten des Standardbranchnamens für Repositorys in deiner Organisation und Richtlinien zur Verwaltung von Repositories in Ihrem Unternehmen erzwingen.

Mit geschützten Branches arbeiten

Geschützte Verzweigungen helfen Betreuern, Regeln für wichtige Verzweigungen zu erzwingen. Eine geschützte Verzweigung kann Push- oder Löschvorgänge blockieren, Statusprüfungen erfordern, Überprüfungen erfordern, codebesitzergenehmigungen anfordern oder signierte Commits erfordern, bevor Änderungen zusammengeführt werden können.

Diese Schutzmaßnahmen helfen Teams dabei, wichtige Zweigstellen stabil zu halten und die Erwartungen deutlich zu machen, bevor eine Pullanforderung zusammengeführt wird. Um festzustellen, ob Ihre Pullanforderung zusammengeführt werden kann, aktivieren Sie das Seriendruckfeld unten auf der Registerkarte " Unterhaltung " der Pullanforderung. Weitere Informationen finden Sie unter Informationen zu geschützten Branches.

Hinweis

Wenn du Repositoryadministrator bist, kannst du Pull Requests in Branches mit aktivierten Branchschutzmechanismen mergen, auch wenn der Pull Request die Anforderungen nicht erfüllt, es sei denn, die Branchschutzmechanismen wurden auf „Include administrators“ festgelegt.

Vergleichen von Verzweigungen in Pullanforderungen

Eine Pullanforderung vergleicht die vorgeschlagenen Änderungen am Head Branch mit dem Basiszweig. Wenn Sie Ihre Pullanforderung erstellen, können Sie den Basiszweig ändern, mit dem Sie Ihre Änderungen vergleichen. Auf der Registerkarte "Dateien geändert " wird angezeigt, was sich ändern würde, wenn die Pullanforderung zusammengeführt wird.

Diff-Ansichten helfen Prüfern, die Änderungen zu verstehen, ohne jeden Commit zu lesen. Sie können einen einheitlichen Diff, split diff, rich diff oder Quell-Diff anzeigen; Leerzeichenänderungen ignorieren; oder filtern Sie Dateien, um sich auf die relevantesten Änderungen zu konzentrieren.

Screenshot der Registerkarte „Geänderte Dateien“ für einen Pull Request. Das Menü „Vergleichsansicht“ ist dunkelorange umrandet.

Diffs werden möglicherweise nicht angezeigt, wenn eine Pullanforderung Repository-Diff-Grenzwerte überschreitet oder eine Datei durch eine Regel in der GITATTRIBUTEs-Datei des Repositorys ausgeblendet wird. Siehe Grenzwerte für Repositorys und Anpassen, wie geänderte Dateien auf GitHub angezeigt werden.

Vergleiche von Three-Dot- (Dreipunkte-) und Two-Dot- (Zweipunkte-) Diffs von Git

Der git diff Befehl unterstützt zwei Vergleichsmethoden. Pullanforderungen beim GitHub Anzeigen eines Dreipunkt-Diffs.

MethodeBefehlVergleiche
Drei Punktegit diff A...BDer neueste allgemeine Commit für beide Verzweigungen (Zusammenführungsbasis) und die neueste Version der Themenverzweigung.
Zwei Punktegit diff A..BDer neueste Status des Basiszweigs (z. B main. ) und die neueste Version des Themenzweigs.

Ein Two-Dot-Diff (Zweipunkte-Diff) vergleicht zwei Git-Committish-Referenzen, wie SHAs oder OIDs (Objekt-IDs), direkt miteinander. On GitHub, the Git committish references in a two-dot diff comparison must be pushed to the same repository or its forks.

Siehe Git-Diff-Optionen auf der Pro Git-Buchwebsite .

Informationen zum Vergleich mit drei Punkten auf GitHub

Da der Drei-Punkt-Vergleich die Zusammenführungsbasis verwendet, konzentriert er sich auf "was eine Pullanforderung eingeführt wird".

Wenn du einen Zwei-Punkt-Vergleich verwendest, ändert sich die Differenz, wenn der Basiszweig aktualisiert wird, selbst wenn du keine Änderungen am Themenzweig vorgenommen hast. Ein Zweipunktvergleich konzentriert sich auch auf die Basisverzweigung, die die von der Themenverzweigung eingeführten Änderungen schwieriger verständlich machen kann.

Im Gegensatz dazu zeigt ein dreipunkteiger Vergleich die Änderungen, die von der Themenzweigung eingeführt wurden, seit die Verzweigungen unterschiedlich sind.

Häufiges Zusammenführen

Um Verwirrung zu vermeiden, führen Sie die Basisverzweigung (z main. B. ) häufig in Ihre Themenverzweigung ein. Wenn Sie die Basisverzweigung zusammenführen, sind die diffs, die von zwei Punkt- und drei Punktvergleichen angezeigt werden, identisch. Es wird empfohlen, eine Pull Request so schnell wie möglich zusammenzuführen. Dies ermutigt Mitwirkende, Pullanforderungen zu verkleinern, was im Allgemeinen empfohlen wird.

Weiterführende Lektüre