Einen Pull Request zu einem Issue verknüpfen

Du kannst einen Pull Request oder Branch mit einem Issue verknüpfen, um zu zeigen, dass ein Fix in Arbeit ist und das Issue automatisch zu schließen, wenn der Pull Request oder Branch gemergt wird.

In diesem Artikel

Über verknüpfte Issues und Pull Requests

Du kannst ein Issue manuell mit einem Pull Request verbinden oder ein unterstütztes Schlüsselwort in der Pull Request-Beschreibung verwenden, d. h. im Zusammenfassungstext, den der Autor beim Erstellen des Pull Requests hinzugefügt hat.

Wenn du einen Pull Request mit dem Issue verknüpfst, der vom Pull Request adressiert wird, dann können Mitarbeiter sehen, dass jemand am Issue arbeitet.

Wenn Sie eine verknüpfte Pull-Anfrage in den Standardbranch eines Repositorys mergen, wird das verknüpfte Issue automatisch geschlossen. Weitere Informationen zum Standard-Branch finden Sie unter Ändern des Standardbranchs.

Hinweis

Die speziellen Schlüsselwörter in einer Pull Request-Beschreibung werden nur interpretiert, wenn es sich beim Ziel des Pull Requests um den Standardbranch des Repositorys handelt. Wenn der Pull-Request auf einen anderen Branch abzielt, werden diese Schlüsselwörter ignoriert, es werden keine Links erstellt und das Zusammenführen des PR hat keinen Einfluss auf die Issues.

Einen Pull Request über ein Stichwort mit einem Issue verknüpfen

Du kannst einen Pull Request mit einem Issue über unterstützte Schlüsselwörter in der Pull Request-Beschreibung oder in einer Commit-Meldung verknüpfen. Der Pull Request muss sich auf dem Standardzweig befinden.

  • close
  • closes
  • closed
  • fix
  • fixes
  • fixed
  • resolve
  • resolves
  • resolved

Wenn du ein Schlüsselwort verwendest, um auf einen Pull Request-Kommentar in einem anderen Pull Request zu verweisen, werden die Pull Requests verknüpft. Durch das Zusammenführen des referenzierenden Pull Requests wird auch der referenzierte Pull Request geschlossen.

Die Syntax für schließende Schlüsselwörter hängt davon ab, ob das Problem im selben Repository wie der Pull-Request ist.

Verknüpftes ProblemSyntaxBeispiel
Problem befindet sich im gleichen RepositorySCHLÜSSELWORT #ISSUE-NUMMERCloses #10
Issue ist in einem unterschiedlichen RepositorySCHLÜSSELWORT BESITZER/REPOSITORY#ISSUE-NUMMERFixes octo-org/octo-repo#100
Mehrere ProblemeVerwende für jeden Issue die vollständige SyntaxResolves #10, resolves #123, resolves octo-org/octo-repo#100

Die Schlüsselwörter können mit Doppelpunkten versehen sein oder in Großbuchstaben geschrieben werden. Zum Beispiel: Closes: #10, CLOSES #10, oder CLOSES: #10.

Nur manuell verknüpfte Pull Requests können manuell getrennt werden. Um die Verknüpfung eines Issues zu trennen, den du über ein Schlüsselwort verknüpft hast, musst du die Pull Request-Beschreibung bearbeiten, um das Schlüsselwort zu entfernen.

Du kannst schließende Schlüsselwörter auch in einer Commit-Mitteilung verwenden. Das Problem wird geschlossen, wenn Sie den Commit in den Standardzweig zusammenführen, aber der Pull Request, der den Commit enthält, wird nicht als verknüpfter Pull Request aufgeführt.

Manuelles Verknüpfen eines Pull Requests mit einem Issue mithilfe der Pull Request-Randleiste

Jeder, der über Schreibberechtigungen für ein Repository verfügt, kann einen Pull Request über die Pull Request-Randleiste manuell mit einem Issue verknüpfen.

Du kannst bis zu 10 Issues manuell mit jedem Pull Request verknüpfen. Der Issue und der Pull Request müssen im gleichen Repository sein.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Pull requests.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Pull Requests“ dunkelorange umrandet.

  3. Klicke in der Liste der Pull Requests auf den Pull Request, den du mit einem Issue verknüpfen möchtest.

  4. Klicke auf der rechten Randleiste auf Entwicklung.

    Screenshot der Randleiste des Issues. „Entwicklung“ ist dunkelorange umrandet.

  5. Klicke auf den Issue, den du mit dem Pull Request verknüpfen willst.

Manuelles Verknüpfen eines Pull Requests oder eines Branches mit einem Issue mithilfe der Issue-Seitenleiste

Jeder, der über Schreibberechtigungen für ein Repository verfügt, kann einen Pull Request oder einen Branch über die Issuerandleiste manuell mit einem Issue verknüpfen.

Du kannst bis zu 10 Issues manuell mit jedem Pull Request verknüpfen. Das Issue kann sich in einem anderen Repository befinden als der verknüpfte Pull Request oder Branch. Dein zuletzt ausgewähltes Repository wird gespeichert.

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Repositorynamen auf Issues.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Issues“ dunkelorange umrandet.

  3. Klicke in der Liste der Issues auf das Issue, mit dem du einen Pull Request oder einen Branch verknüpfen möchtest.

  4. Klicke auf der rechten Randleiste auf Entwicklung.

    Screenshot der Randleiste des Issues. „Entwicklung“ ist dunkelorange umrandet.

  5. Klicke auf das Repository, das den Pull Request oder den Branch enthält, den du mit dem Issue verknüpfen möchtest.

  6. Klicke den Pull Request oder den Branch, den du mit dem Issue verknüpfen möchtest.

  7. Klicken Sie auf Anwenden.

Weiterführende Lektüre

  •         [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#issues-and-pull-requests)