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.

Hinweis

Um die Funktion auszuprobieren, stellen Sie sicher, dass sie unter Tools>Optionen>Previewfunktionen>Pull Request aktiviert ist

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.

  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.

Mit Visual Studio 17.12 und höher können Sie das Feature "Pullanforderungsvorlagen" (in tools Options>>) aktivieren, sodass Ihre pr-Standardvorlage in Ihrem Repository beim Erstellen einer neuen Pullanforderung sowohl für GitHub als auch für Azure DevOps verwendet wird. 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

Zum Aktivieren dieses Features öffnen Sie Tools>Optionen>Vorschau-Features und wählen Sie Pull Request-Kommentare aus.

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.

Zum Aktivieren dieses Features öffnen Sie Tools>Optionen>Vorschau-Features und wählen Sie Pull Request-Kommentare aus. Nachdem diese aktiviert wurden, checken Sie Branches mit aktiven Pull Requests aus, und klicken Sie in der Infoleiste auf Kommentare in Dateien anzeigen, und 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.

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