Udostępnij za pośrednictwem


Utwórz pull request w programie Visual Studio

Jeśli jesteś uwierzytelniony w usłudze GitHub lub Azure DevOps i wypchnąłeś zmiany do zdalnego repozytorium, możesz utworzyć pull request bez wychodzenia z programu Visual Studio. Pull Requesty to podstawowe narzędzie w usługach GitHub i Azure DevOps do przeglądu kodu. Te przeglądy pomagają wychwytywać problemy w nowych funkcjach i umożliwiają kolegom z zespołu dzielenie się swoim doświadczeniem z różnymi regionami bazy kodu — ogólną poprawę kondycji bazy kodu.

Notatka

Aby wypróbować tę funkcję, upewnij się, że jest ona włączona w obszarze narzędzia Tools>Options>Preview Features>Pull Request

Aby utworzyć pull request, wykonaj następujące kroki:

  1. Przed utworzeniem żądania ściągnięcia należy utworzyć nową gałąź dla zmian. Ta gałąź przechowuje modyfikacje oddzielnie od gałęzi głównej, dopóki nie będą gotowe do scalenia.

  2. Następnie możesz zatwierdzić i wypchnąć zmiany, jak zwykle w oknie Zmiany usługi Git.

  3. Wybierz link na banerze powiadomień, aby Utwórz w programie Visual Studio lub Utwórz w przeglądarce.

    Zrzut ekranu przedstawiający okno Zmiany usługi Git z paskiem informacyjnym

    Alternatywnie możesz utworzyć prośbę o pobranie z gałęzi zdalnej, przechodząc do okna Nowa prośba o pobranie za pomocą menu głównego poziomu Git>GitHub lub Azure DevOps>Nowa prośba o pobranie. Możesz też kliknąć prawym przyciskiem myszy gałąź w oknie Repozytorium Git.

    Menu główne Git z wybranym GitHub i wyróżnionym tekstem

    Możesz też wybrać gałąź w oknie repozytorium Git, aby otworzyć menu kontekstowe i wybrać nowe żądanie ściągnięcia.

    okno Repozytorium Git z wyróżnionym tekstem linków wychodzących/przychodzących w programie Visual Studio 2022.

  4. Wybierz gałąź, z którą chcesz scalić, i nadaj żądaniu ściągnięcia opisowy tytuł i opis. Aby sformatować opis żądania pobrania z programu Visual Studio, możesz użyć składni języka znaczników markdown . Wypróbuj to, wpisując symbole markdown w polu Opis i wyświetlając podgląd markdown, wybierając przycisk Podgląd.

    Napiwek

    W programie Visual Studio 2022 w wersji 17.10 lub nowszej oraz rozszerzeniach GitHub Copilot można użyć sztucznej inteligencji do wygenerowania szczegółowego opisu żądania ściągnięcia opisującego zmiany. Naciśnij ikonę długopisu z blaskiem, aby poprosić GitHub Copilot o wygenerowanie opisu pull requesta. Aby zainstalować narzędzie GitHub Copilot, zobacz Instalowanie narzędzia GitHub Copilot i zarządzanie nim w programie Visual Studio.

    Zrzut ekranu przedstawiający ikonę błyszczącego pióra, aby poprosić o wygenerowanie opisu pull requestu przez narzędzie GitHub Copilot.

    Okno Nowego Żądania Ściągnięcia z tekstem przycisku Podglądu wyróżnionym w programie Visual Studio 2022.

  5. Podgląd różnicy umożliwia wyświetlenie wszystkich zmian w plikach, które zostały zatwierdzone w ramach pull requesta. Zobacz Porównanie plików — widok różnic.

    Napiwek

    Opcja widoku różnic podsumowania umożliwia przeglądanie tylko zmienionych sekcji kodu.

    Okno Pull Request z podświetlonym tekstem przycisku podsumowania w programie Visual Studio 2022.

  6. Można łączyć elementy robocze, odwołując się do nich w wyszukiwarce za pomocą , wpisując # w polu opisu lub naciskając przycisk # w prawym dolnym rogu. Możesz również dodać recenzentów, wpisując nazwę użytkownika usługi GitHub lub tożsamość lub adres e-mail usługi Azure DevOps.

    Nowe żądanie Pull Request z numerem # w polu opisu oraz lista powiązanych problemów i żądań Pull Request z GitHub wyświetlanych w programie Visual Studio 2022.

  7. Kiedy klikniesz Utwórz na swoim pull request, inni deweloperzy mogą przejrzeć twoje zmiany i przekazać opinię. Lub w programie Visual Studio 17.12 lub nowszym kliknij menu rozwijane i wybierz Utwórz jako wersję roboczą.

    Zrzut ekranu przedstawiający opcję utworzenia nowego pull requesta jako wersji roboczej.

W programie Visual Studio 17.12 lub nowszym można włączyć funkcję szablonów pull request (w Narzędziach Opcje>Środowisko>Funkcje Preview>), aby domyślny szablon pull request w repozytorium był używany podczas tworzenia nowego pull request dla GitHub i Azure DevOps. Dowiedz się więcej o dodawaniu szablonu pull request do swojego repozytorium w dokumentacji GitHub oraz dokumentacji Azure DevOps .

Przeglądaj lub dodawaj komentarze do pull requestów w edytorze

W programie Visual Studio 17.11 lub nowszym można wyświetlać komentarze i sugestie recenzentów bez przełączania kontekstów do przeglądarki.

Zrzut ekranu przedstawiający komentarze w pull request.

Aby włączyć tę funkcję, otwórz Tools>Options>Preview features i upewnij się, że wybrano Komentarze dotyczące próśb ściągnięcia.

Wyświetl komentarze pull requesta

Aby wyświetlić komentarze dotyczące pull requestu, przejdź do dowolnej gałęzi z aktywnym pull requestem i wybierz pozycję Pokaż komentarze w plikach z paska informacji. Możesz również wybrać numer PR w oknie Git Changes lub z menu głównego Git przy użyciu Git>GitHub lub Azure DevOps>Pokaż komentarze w plikach.

Zrzut ekranu przedstawiający link do wyświetlania komentarzy w oknie Zmiany usługi Git.

Dodaj komentarze do pull requestu

W programie Visual Studio 17.13 lub nowszym możesz przejrzeć żądanie ściągnięcia lub dodać komentarze.

Aby włączyć tę funkcję, otwórz Tools>Options>Preview features i upewnij się, że wybrano Komentarze do żądania ściągnięcia. Gdy już je aktywujesz, przełącz się na dowolną gałąź z aktywnym żądaniem ściągnięcia i kliknij Pokaż komentarze w plikach na pasku informacyjnym, a następnie przejdź przez zmiany za pomocą przycisków paska narzędzi powyżej pliku kodu.

Aby dodać komentarz, kliknij ikonę Dodaj komentarz po lewej stronie edytora, jak pokazano na poniższym zrzucie ekranu.

Zrzut ekranu przedstawiający ikonę Dodaj komentarz podczas przeglądania zmiany pliku w pull request.

Możesz również kliknąć prawym przyciskiem myszy wiersz kodu, a następnie w menu kontekstowym wybierz pozycję Git>Dodaj komentarz.

Tekst komentarza nie zostanie opublikowany, dopóki nie klikniesz przycisku Dodaj komentarz w oknie komentarza.

Możesz kontynuować konwersację dotyczącą istniejącego komentarza, korzystając z sekcji Odpowiedz w polu komentarza. Komentarze są aktywne lub rozwiązane. Możesz kliknąć Odpowiedz i Rozwiąż, aby odpowiedzieć na komentarz i zmienić jego status na rozwiązany jednym kliknięciem, lub zmienić status przy użyciu listy rozwijanej powyżej tekstu komentarza.

Możesz zmienić status polubienia komentarza, klikając ikonę, lub klikając trzy kropki, możesz skopiować tekst komentarza do schowka, skopiować link do komentarza do schowka, usunąć komentarz lub otworzyć komentarz w przeglądarce internetowej w witrynie dostawcy (np. github.com lub witrynie projektu usługi Azure DevOps).

Możliwość dodawania komentarzy do pull requestów jest ograniczona u niektórych dostawców Git. Na przykład, używając GitHub jako usługodawcy, można dodawać komentarze tylko w wierszach w zakresie 3 wierszy od zmiany, ale przy użyciu usługodawcy Azure DevOps, można dodawać komentarze w dowolnym wierszu pliku zaangażowanego w pull request. W każdym razie można dodawać komentarze tylko do plików uwzględnionych w żądaniu ściągnięcia.

Korzystanie z klawiatury

Możesz nawigować po plikach i poszczególnych komentarzach przy użyciu ikon na pasku narzędzi lub użyć następujących skrótów klawiaturowych:

Akcja Skrót klawiszowy
Przejdź do poprzedniego pliku w żądaniu ściągnięcia Ctrl+Shift+Alt+F6
Przejdź do następnego pliku w żądaniu ściągnięcia Ctrl+Alt+F6
Przejdź do poprzedniego komentarza Ctrl+Shift+Alt+F8
Przejdź do następnego komentarza Ctrl+Alt+F8
Ukrywanie komentarzy w plikach Ctrl+Shift+F1

Następne kroki

Aby kontynuować podróż, odwiedź stronę Pobieranie, ściąganie i synchronizowanie w programie Visual Studio.

Zobacz też