Freigeben über


Erstellen einer Pullanforderung in Visual Studio

Wenn Sie bei GitHub oder Azure DevOps authentifiziert sind und Änderungen an Ihr Remote-Repository übertragen haben, können Sie eine Pullanforderung erstellen, ohne Visual Studio zu verlassen. Pullanforderungen sind ein wesentliches Tool in GitHub und Azure DevOps für die Codeüberprüfung. Diese Rezensionen helfen dabei, Probleme in neuen Features aufzufangen und Teamkollegen das Teilen ihrer Erfahrungen mit verschiedenen Regionen der Codebasis zu ermöglichen – die Integrität der Codebasis insgesamt zu verbessern.

Führen Sie die folgenden Schritte aus, um eine Pullanforderung zu erstellen:

  1. Bevor Sie eine Pullanforderung erstellen können, müssen Sie eine neue Verzweigung für Ihre Änderungen erstellen. Diese Verzweigung trennt Ihre Änderungen von der Hauptverzweigung, bis sie zusammengeführt werden können.

  2. Dann können Sie Ihre Änderungen wie gewohnt im Fenster Git Changes festschreiben und veröffentlichen.

  3. Wählen Sie im Benachrichtigungsbanner den Link zu In Visual Studio erstellen oder Im Browser erstellen aus.

    Screenshot des Fensters „Git-Änderungen“ mit der Infoleiste „Der Pushvorgang von QP nach ‚origin/master‘ war erfolgreich. Pull Request: In Visual Studio erstellen oder im Browser erstellen.“ in Visual Studio 2022.

    Alternativ können Sie einen Pull Request von einem entfernten Branch aus erstellen, indem Sie zum Fenster Neuer Pull Request über das Menü auf der obersten Ebene navigieren: Git>GitHub oder Azure DevOps>Neuer Pull Request. Oder klicken Sie mit der rechten Maustaste auf eine Verzweigung im Git-Repositoryfenster.

    Das Git-Menü auf der obersten Ebene mit ausgewählter Option „GitHub“ und hervorgehobenem Text „Neuer Pull Request“ in Visual Studio 2022.

    Oder wählen Sie im Git Repository-Fenster eine Verzweigung aus, um das Kontextmenü zu öffnen und Neue Pullanforderung auszuwählen.

    Das Fenster „Git Repository“ mit hervorgehobenem Linktext „ausgehend/eingehend“ in Visual Studio 2022.

    Wenn Sie versuchen, eine Pull-Anforderung zu erstellen, aber mehrere Konten in Ihrem Schlüsselbund haben, wird eine Eingabeaufforderung angezeigt, in der Sie gefragt werden, welches Konto sie verwenden soll. Siehe Hinzufügen von GitHub-Konten zu Ihrem Schlüsselbund.

  4. Wählen Sie die Verzweigung aus, in die Sie zusammenführen möchten, und geben Sie Ihrer Pullanforderung einen beschreibenden Titel und eine Beschreibung. Sie können die Markdownsyntax verwenden, um die Beschreibung der Pullanforderung aus Visual Studio zu formatieren. Probieren Sie es aus, indem Sie die Markdownsymbole im Feld Beschreibung eingeben und ihre Markdownvorschau anzeigen, indem Sie die Schaltfläche Vorschau auswählen.

    Tipp

    Mit Visual Studio 2022, Version 17.10 und höher und den GitHub Copilot-Erweiterungen, können Sie KI verwenden, um eine detaillierte Beschreibung des Pull Request und Ihrer Änderungen generieren. Drücken Sie das funkelnde Stiftsymbol, um anzufordern, dass GitHub Copilot eine PR-Beschreibung generiert. Informationen zum Installieren von GitHub Copilot finden Sie unter Installieren und Verwalten von GitHub Copilot in Visual Studio.

    Screenshot des funkelnden Stiftsymbols, um anzufordern, dass GitHub Copilot eine PR-Beschreibung generiert.

    Das Fenster „Neuer Pull Request“ mit hervorgehobener Schaltfläche „Vorschau“ in Visual Studio 2022.

  5. Die Differenzvorschau ermöglicht es Ihnen, alle Änderungen in den Dateien anzuzeigen, die als Teil Ihrer Pullanforderung zugesichert wurden. Siehe Compare files - diff view.

    Tipp

    Mit der Option „Übersichtsdifferenzansicht“ können Sie nur die geänderten Codeabschnitte überprüfen.

    Das Fenster „Neuer Pull Request“ mit hervorgehobener Schaltfläche „Zusammenfassung“ in Visual Studio 2022.

  6. Sie können Arbeitsaufgaben verknüpfen, indem Sie mit der Problemsuche darauf verweisen, indem Sie in das Beschreibungsfeld eingeben # oder in der unteren rechten Ecke die #-Schaltfläche drücken. Sie können Ihre Reviewer auch hinzufügen, indem Sie ihren GitHub-Benutzernamen oder ihre Azure DevOps-Identität oder E-Mail eingeben.

    Der neue Pull Request mit # im Beschreibungsfeld und eine Liste der zugehörigen GitHub-Probleme und Pull Requests, die in Visual Studio 2022 angezeigt werden.

  7. Sobald Sie bei Ihrer Pull-Anfrage auf Erstellen geklickt haben, können andere Entwickler Ihre Änderungen überprüfen und Feedback geben. Oder klicken Sie mit Visual Studio 17.12 und höher auf die Dropdownliste, und wählen Sie "Als Entwurf erstellen" aus.

    Screenshot der Option zum Erstellen einer neuen Pullanforderung als Entwurf.

Erfahren Sie mehr darüber, wie Sie Ihrem Repository in der GitHub-Dokumentation und der Azure DevOps-Dokumentation eine Pull-Anforderungsvorlage hinzufügen.

Anzeigen oder Hinzufügen von Pull Request-Kommentaren im Editor

Mit Visual Studio 17.11 oder höher können Sie Kommentare und Vorschläge von Rezensenten anzeigen, ohne den Kontext in den Browser wechseln zu müssen.

Screenshot: PR-Kommentare

Um dieses Feature zu aktivieren, öffnen Sie den Bereich ">", erweitern Sie den Abschnitt "Alle Einstellungen>", und aktivieren Sie das Kontrollkästchen "Pull-Request-Kommentare".

Um dieses Feature zu aktivieren, öffnen Sie das Dialogfeld "Extras">"Optionen", und erweitern Sie den Abschnitt "Umgebung">"Vorschaufeatures". Aktivieren Sie das Kontrollkästchen "Kommentare abrufen" und dann "OK".

Pull-Request-Kommentare anzeigen

Zum Anzeigen der Kommentare eines Pull Request rufen Sie einen beliebigen Branch mit einem aktiven Pull Request-Branch auf und wählen Sie in der Infoleiste Kommentare in Dateien anzeigen aus. Sie können die PR-Nummer auch im Fenster Git-Änderungen oder im Git-Menü der obersten Ebene auswählen, indem Sie > oder Azure DevOps> auswählen.

Screenshot: Link zum Anzeigen von Kommentaren im Fenster „Git-Änderungen“.

Kommentare zu Pull-Requests hinzufügen

Mit Visual Studio 17.13 oder höher können Sie eine Pullanforderung überprüfen oder Kommentare hinzufügen. Um dieses Feature zu aktivieren, öffnen Sie den Bereich Extras>Optionen, erweitern Sie den Abschnitt Alle Einstellungen>Vorschaufeatures, und aktivieren Sie das Kontrollkästchen Pull-Request-Kommentare.

Mit Visual Studio 17.13 oder höher können Sie eine Pullanforderung überprüfen oder Kommentare hinzufügen. Um diese Funktion zu aktivieren, öffnen Sie das Dialogfeld Extras>Optionen, und öffnen Sie den Abschnitt Umgebung>Vorschaufunktionen. Aktivieren Sie das Kontrollkästchen "Kommentare abrufen" und dann "OK".

Nachdem Sie Kommentare aktiviert haben, checken Sie jede Verzweigung mit einer aktiven Pullanforderung aus, und klicken Sie auf " Kommentare in Dateien anzeigen " in der Infoleiste. Navigieren Sie mithilfe der Symbolleistenschaltflächen über der Codedatei durch die Änderungen.

Wenn Sie einen Kommentar hinzufügen möchten, klicken Sie auf das Symbol Kommentar hinzufügen links im Editor, wie im folgenden Screenshot gezeigt.

Screenshot mit dem Symbol „Kommentar hinzufügen“ beim Überprüfen einer Dateiänderung in einem Pull Request.

Sie können auch mit der rechten Maustaste auf eine Codezeile klicken und im Kontextmenü die Option Git>Kommentar hinzufügenauswählen.

Der Kommentartext wird erst veröffentlicht, wenn Sie im Kommentarfenster auf die Schaltfläche " Kommentar hinzufügen " klicken.

Sie können die Unterhaltung bei einem vorhandenen Kommentar fortsetzen, indem Sie den Bereich Antwort im Kommentarfeld verwenden. Kommentare sind entweder aktiv oder gelöst. Sie können auf Antworten und auflösen klicken und dadurch mit einem Klick auf einen Kommentar antworten und den Status auf „Gelöst“ setzen oder den Status mithilfe der Dropdownliste oberhalb des Kommentartexts ändern.

Sie können den Status „Gefällt mir“ für einen Kommentar umschalten, indem Sie auf das Symbol klicken oder auf die drei Punkte klicken, den Kommentartext in die Zwischenablage kopieren, einen Link zum Kommentar in die Zwischenablage kopieren, den Kommentar löschen oder den Kommentar im Webbrowser auf der Website des Anbieters öffnen (z. B. github.com oder Ihre Azure DevOps-Projektwebsite).

Die Möglichkeit zum Hinzufügen von Kommentaren zu einer Pullanforderung ist für einige Git-Anbieter beschränkt. Beispielsweise können Sie mit GitHub als Anbieter nur Kommentare in Zeilen innerhalb von drei Zeilen einer Änderung hinzufügen, aber mit dem Azure DevOps-Anbieter können Sie Kommentare in einer beliebigen Zeile einer Datei hinzufügen, die an der Pullanforderung beteiligt ist. In jedem Fall können Sie nur Kommentare zu Dateien hinzufügen, die in der Pullanforderung enthalten sind.

Anzeigen von Kommentaren in der Diff-Ansicht

Sie können Kommentare in der Diff-Ansicht sowie in der Dateiansicht anzeigen. In der Vergleichsansicht werden Kommentare zusammen mit dem ursprünglichen und dem geänderten Code angezeigt. So sehen Sie ganz einfach, was warum geändert wurde. Sie können die Arbeitsdatei in dieser Ansicht auch bearbeiten.

Screenshot eines PR-Kommentars in der Diff-Ansicht.

Markdownformatierung in Kommentaren

In der Dateiansicht oder der Diff-Ansicht werden Kommentare mit Markdown-Formatierung gerendert.

Screenshot eines PR-Kommentars mit Markdown-Formatierung

Verwenden Sie die Tastatur

Verwenden Sie die Symbole aus der Symbolleiste oder die folgenden Tastenkombinationen, um durch Dateien und einzelne Kommentare zu navigieren:

Aktion Tastenkombinationen
Zugreifen auf die vorherige Datei im Pull Request STRG+UMSCHALT+Alt+F6
Zugreifen auf die nächste Datei im Pull Request STRG+Alt+F6
Zugreifen auf den vorherigen Kommentar STRG+UMSCHALT+Alt+F8
Zugreifen auf den nächsten Kommentar STRG+ALT+F3
Ausblenden von Kommentaren in Dateien STRG+Umschalttaste+F1

Nächste Schritte

Um Ihre Journey fortzusetzen, besuchen Sie die Seite zum Abrufen, Pullen und Synchronisieren in Visual Studio.

Weitere Informationen