Einen Pull Request zu einem Issue verknüpfen

Du kannst einen Pull Request oder Branch mit einem Issue verknüpfen, um anzuzeigen, dass ein Fix in Bearbeitung ist und dass das Issue automatisch geschlossen werden soll, wenn der Pull Request oder Branch gemergt wird.

In diesem Artikel

Note

Die speziellen Schlüsselwörter in einer Pull Request-Beschreibung werden interpretiert, wenn der Pull Request auf den Standardbranch des Repositorys ausgerichtet ist. Wenn die PR-Basis jedoch einen anderen Branch ist, werden diese Schlüsselwörter ignoriert, werden keine Links erstellt und das Zusammenführen des PR hat keine Auswirkungen auf die Probleme. Wenn du eine Pull Request mit einem Schlüsselwort verknüpfen möchtest, muss sich der PR auf der Standardverzweigung befinden.

Über verknüpfte Issues und Pull Requests

Du kannst einen Pull Request mit einem Issue über unterstützte Schlüsselwörter in der Pull Request-Beschreibung verknüpfen.

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 du einen verknüpften Pull Request in den Standard-Branch eines Repository zusammenführst, werden seine verknüpften Issues automatisch geschlossen. Weitere Informationen zum Standardbranch findest du unter Ändern des Standardbranchs.

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 der Standardverzweigung 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 der Issue im gleichen Repository ist wie der Pull Request.

Verknüpfter IssueSyntaxBeispiel
Issue ist im gleichen RepositorySCHLÜSSELWORT #ISSUE-NUMMERCloses #10
Issue ist in einem unterschiedlichen RepositorySCHLÜSSELWORT BESITZER/REPOSITORY#ISSUE-NUMMERFixes octo-org/octo-repo#100
Mehrfache IssuesVerwende für jeden Issue die vollständige SyntaxResolves #10, resolves #123, resolves octo-org/octo-repo#100

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. Der Issue wird geschlossen, wenn du den Commit in den Standardbranch zusammenführst, 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 Branchs mit einem Issue mithilfe der Issuerandleiste

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 Namen deines Repositorys 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. Klicke auf Anwenden.

Weiterführende Themen