Skip to main content

Vorgeschlagene Änderungen in einem Pull Request überprüfen

In einem Pull Request kannst du Commits, geänderte Dateien und die Differenzen (Diffs) zwischen den Dateien im Basisbranch und in den Vergleichsbranches überprüfen und besprechen.

Tool navigation

Informationen zum Review von Pull Requests

Du kannst die Änderungen in einem Pull Request eine Datei nach der anderen überprüfen. Beim Überprüfen der Dateien in einem Pull Request kannst du einzelne Kommentare zu bestimmten Änderungen hinterlassen. Nachdem du den Review der einzelnen Dateien abgeschlossen hast, kannst du sie als „gesehen“ markieren. Dadurch wird die Datei ausgeblendet, so dass du die noch nicht geprüften Dateien leichter findest. Eine Statusleiste im Pull Request-Header zeigt die Anzahl der eingesehenen Dateien an. Nachdem du so viele Dateien wie gewünscht überprüft hast, kannst du den Pull Request genehmigen oder zusätzliche Änderungen anfordern, indem du den Review mit einem Zusammenfassungskommentar übermittelst.

Tipp: Du findest einen Pull Request, wenn du oder ein Team, dem du angehörst, mit dem Suchqualifizierer review-requested:[USERNAME] oder team-review-requested:[TEAMNAME] zum Review angefordert wirst. Weitere Informationen findest du unter Issues und Pull Requests durchsuchen.

Review starten

  1. 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.

  2. Klicke in der Liste der Pull Requests auf den Pull Request, den Du überprüfen möchtest.

  3. Klicke für den Pull Request auf Dateien geändert.

    Screenshot der Registerkarten für einen Pull Request. Die Registerkarte „Dateien geändert“ ist dunkelorange umrandet. Du kannst das Format der Diff-Ansicht auf dieser Registerkarte ändern, indem du auf klickst und die einheitliche oder geteilte Ansicht auswählst. Die getroffene Auswahl wird angewendet, wenn du die Diff-Ansicht für andere Pull Requests anzeigst.

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

    Du kannst auch Leerzeichenunterschiede ausblenden. Die getroffene Auswahl gilt nur für diesen Pull Request und wird für deinen nächsten Besuch dieser Seite gespeichert.

  4. Wahlweise kannst du die Dateien filtern, um nur die Dateien anzuzeigen, die du überprüfen möchtest, oder die Dateistruktur verwenden, um zu einer bestimmten Datei zu navigieren. Weitere Informationen findest du unter Dateien in einem Pull Request filtern.

  5. Bewege den Mauszeiger über die Codezeile, der du einen Kommentar hinzufügen möchtest, und klicke auf das blaue Kommentarsymbol. Um mehreren Zeilen einen Kommentar hinzuzufügen, wähle durch Klicken und Ziehen den gewünschten Zeilenbereich aus, und klicke dann auf das blaue Kommentarsymbol.

    Screenshot eines Diffs in einem Pull Request. Das blaue Pluszeichensymbol neben einer Zeilennummer ist orange umrandet.

  6. Gib im Kommentarfeld Deinen Kommentar ein.

  7. Optional: Wenn du eine bestimmte Änderung an einer oder mehreren Zeilen vorschlagen möchtest, klicke auf , und bearbeite dann den Text im Vorschlagsblock.

    Screenshot: Kommentarfeld für eine Überprüfung. Das Symbol für Dateiunterschiede, das eine bestimmte Änderung anzeigt, ist dunkelorange umrandet.

  8. Um eine Datei direkt zu kommentieren, klicke rechts neben der Datei auf , und gib deinen Kommentar ein.

    Screenshot: Bilddatei auf der Seite „Geänderte Dateien“ eines Pull Requests. Rechts neben der Bilddatei ist ein Kommentarsymbol orange umrandet.

  9. Wenn du fertig bist, klicke auf Review starten. Wenn du bereits einen Review gestartet hast, kannst du auf Reviewkommentar hinzufügen klicken.

Vor dem Absenden des Reviews haben deine Zeilenkommentare den Status Ausstehend und sind nur für dich sichtbar. Ausstehende Kommentare kannst du vor dem Absenden des Reviews jederzeit bearbeiten. Um einen ausstehenden Review einschließlich aller ausstehenden Kommentare abzubrechen, können Sie über dem geänderten Code auf Änderungen überprüfen und dann auf Review abbrechen klicken.

Screenshot: Kommentarfeld für einen Review. Die Schaltfläche „Review abbrechen“ ist dunkelorange umrandet.

Du kannst GitHub Codespaces verwenden, um Pull Requests zu testen, auszuführen und zu überprüfen.

  1. Öffne den Pull Request wie in Verwenden von GitHub Codespaces für Pull Requests beschrieben in einem Codespace.

  2. Klicke in der Aktivitätsleiste auf die Ansicht GitHub-Pull-Request. Diese Ansicht wird nur angezeigt, wenn du einen Pull Request in einem Codespace öffnest.

    Screenshot der VS Code-Aktivitätsleiste. Der Mauszeiger zeigt auf ein Symbol, das die QuickInfo „GitHub-Pull Request“ anzeigt.

  3. Klicke zum Überprüfen einer bestimmten Datei auf das Symbol Datei öffnen in der Randleiste.

    Screenshot der Randleiste „GitHub-Pull Request“. Ein Dateiname ist dunkelorange umrandet.

  4. Klicke zum Hinzufügen von Überprüfungskommentaren auf das + -Symbol neben der Zeilennummer. Gib deinen Überprüfungskommentar ein, und klicke dann auf Überprüfung starten.

    Screenshot eines Kommentars „Yes, I agree, this is clearer“, der hinzugefügt wird. Die Schaltfläche „Überprüfung starten“ wird unter dem Kommentar angezeigt.

  5. Optional können Sie eine Änderung vorschlagen, auf die der Autor des Pull Requests klicken kann, um sich zu verpflichten, wenn sie mit Ihrem Vorschlag einverstanden sind. Klicken Sie dazu auf das +-Zeichen neben der ersten Zeile, deren Änderung Sie vorschlagen möchten, und halten Sie es gedrückt. Ziehen Sie dann das +-Zeichen auf die letzte Zeile, deren Änderung Sie vorschlagen möchten. Klicken Sie dann im angezeigten Kommentarfeld auf Einen Vorschlag erstellen.

    Die ausgewählten Zeilen werden in das Kommentarfeld kopiert, wo Sie sie bearbeiten können, um eine Änderung vorzuschlagen. Sie können einen Kommentar über der Zeile mit ```suggestion hinzufügen, um Ihren Änderungsvorschlag zu erläutern.

    Klicken Sie auf Kommentar hinzufügen, um Ihren Vorschlag zum Pull Request hinzuzufügen.

    Screenshot einer vorgeschlagenen Änderung. Die Schaltflächen „Einen Vorschlag erstellen“ und „Kommentar hinzufügen“ werden unterhalb der vorgeschlagenen Änderung angezeigt.

  6. Nach dem Hinzufügen von Überprüfungskommentaren kannst du in der Randleiste auswählen, entweder die Kommentare zu senden, die Änderungen zu genehmigen oder Änderungen anzufordern.

    Screenshot der Randleiste mit den Dropdownoptionen „Kommentieren und übermitteln“, „Genehmigen und übermitteln“ und „Änderungen anfordern und übermitteln“.

Weitere Informationen zum Überprüfen von Pull Requests in GitHub Codespaces findest du unter Verwenden von GitHub Codespaces für Pull Requests.

Überprüfen von Abhängigkeitsänderungen

Wenn der Pull Request Änderungen an Abhängigkeiten enthält, kannst du mithilfe der Abhängigkeitsüberprüfung für eine Manifest- oder Sperrdatei feststellen, was geändert wurde und ob die Änderungen Sicherheitsrisiken einführen. Weitere Informationen findest du unter Überprüfen von Abhängigkeitsänderungen in einem Pull Request.

  1. Klicke für den Pull Request auf Dateien geändert.

    Screenshot der Registerkarten für einen Pull Request. Die Registerkarte „Dateien geändert“ ist dunkelorange umrandet.

  2. Zeige rechts neben dem Header für eine Manifest- oder Sperrdatei den Abhängigkeitsreview an, indem du auf die Rich-Diff-Schaltfläche klickst.

    Screenshot: Registerkarte „Geänderte Dateien“ eines Pull Requests. Die Schaltfläche zum Anzeigen des Rich-Diff (gekennzeichnet durch ein Dateisymbol) ist dunkelorange umrandet.

  3. Du solltest auch das Quell-Diff überprüfen, da es möglicherweise Änderungen an der Manifest- oder Sperrdatei gibt, die keine Abhängigkeiten ändern. Zudem besteht die Möglichkeit, dass Abhängigkeiten verfügbar sind, die GitHub nicht analysieren kann und die daher nicht in der Abhängigkeitsüberprüfung angezeigt werden.

    Klicke auf die Schaltfläche , um zur Ansicht für das Quelldiff zurückzukehren.

    Screenshot der Registerkarte „Geänderte Dateien“ eines Pull Requests. Die Schaltfläche zum Anzeigen des Quelldiffs, die mit einem Codesymbol versehen ist, ist dunkelorange umrandet.

Datei als „gesehen“ markieren

Wenn du den Review einer Datei abgeschlossen hast, kannst du sie als „gesehen“ markieren, um sie auszublenden. Falls die Datei nach deiner Überprüfung geändert wird, wird die Markierung aufgehoben.

  1. Klicke für den Pull Request auf Dateien geändert.

    Screenshot der Registerkarten für einen Pull Request. Die Registerkarte „Dateien geändert“ ist dunkelorange umrandet.

  2. Aktiviere rechts neben dem Header der überprüften Datei das Kontrollkästchen Gesehen.

    Screenshot: Header einer Datei. Die Option „Gesehen“ ist dunkelorange umrandet.

Review absenden

Wenn du den Review aller von Dir im Pull Request einzuschließenden Dateien abgeschlossen hast, sende den Review ab.

  1. Klicke für den Pull Request auf Dateien geändert.

    Screenshot der Registerkarten für einen Pull Request. Die Registerkarte „Dateien geändert“ ist dunkelorange umrandet.

  2. Klicke oberhalb des geänderten Codes auf Änderungen überprüfen.

    Screenshot der Registerkarte „Geänderte Dateien“ eines Pull Requests. Die Schaltfläche „Änderungen überprüfen“ ist dunkelorange umrandet.

  3. Gib einen Kommentar ein, der Dein Feedback für die vorgeschlagenen Änderungen zusammenfasst.

  4. Wähle die Art des Review aus, den du absenden möchtest:

    • Wähle Kommentar aus, um ein allgemeines Feedback abzugeben, ohne die Änderungen explizit zu genehmigen oder weitere Änderungen anzufordern.
    • Wähle Genehmigen aus, um dein Feedback abzusenden und das Zusammenführen der im Pull Request vorgeschlagenen Änderungen zu genehmigen.
    • Wähle Änderungen anfordern aus, um Feedback abzusenden, auf das eingegangen werden muss, bevor der Pull Request zusammengeführt werden kann.
  5. Klicke auf Review senden.

Tipps:

  • Wenn ein Mitarbeiter mit admin-, owner- oder write-Zugriff auf das Repository einen Review sendet, in dem Änderungen angefordert werden, kann der Pull Request erst gemergt werden, wenn derselbe Mitarbeiter einen weiteren Review sendet, in dem die Änderungen am Pull Request genehmigt werden.
  • Repository-Inhaber und -Administratoren können einen Pull Request sogar dann zusammenführen, wenn er keinen genehmigenden Review erhalten hat oder wenn ein Reviewer, der die Änderungen verlangt hat, die Organisation verlassen hat oder nicht verfügbar ist.
  • Wenn sowohl erforderliche Reviews wie das Verwerfen veralteter Reviews aktiviert sind und ein den Code verändernder Commit an den Branch eines genehmigten Pull Requests übermittelt wird, dann wird die Genehmigung verworfen. Der Pull Request muss erneut überprüft und genehmigt werden, bevor er zusammengeführt werden kann.
  • Wenn verschiedene offene Pull Requests jeweils einen Head-Branch aufweisen, der auf denselben Commit verweist, kannst Du sie nicht zusammenführen, wenn der Review bei einer oder bei beiden ausstehend ist oder abgelehnt wurde.
  • Wenn dein Repository Genehmigungsreviews von Personen mit Schreib- oder Administratorberechtigungen erfordert, werden alle Genehmigungen von Personen mit diesen Berechtigungen mit einem grünen Häkchen markiert, Genehmigungen von Personen ohne diese Berechtigungen erhalten ein graues Häkchen. Genehmigungen mit einem grauen Häkchen wirken sich nicht darauf aus, ob der Pull Request gemergt werden kann.
  • Ersteller von Pull Requests können ihre Pull Requests nicht selbst genehmigen.

Weiterführende Themen