Udostępnij za pomocą


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.

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.

    Gdy próbujesz utworzyć żądanie przeciągnięcia, ale masz wiele kont w menedżerze haseł, pojawi się monit z pytaniem, którego konta użyć. Zobacz Dodaj konta GitHub do pęku kluczy.

  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.

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 okienko Narzędzia>Opcje, rozwiń sekcję Wszystkie ustawienia>Funkcje w wersji zapoznawczej i zaznacz pole wyboru Komentarze żądania ściągnięcia.

Aby włączyć tę funkcję, otwórz okno dialogowe Opcje narzędzi> i rozwiń sekcjęFunkcje środowiska> w wersji zapoznawczej. Zaznacz pole wyboru Komentarze żądania ściągnięcia, a następnie wybierz OK.

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 okienko Narzędzia>, rozwiń sekcję Ustawienia> i zaznacz pole wyboru Komentarze Pull Request.

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 okno dialogowe Opcje narzędzi> i rozwiń sekcjęFunkcje środowiska> w wersji zapoznawczej. Zaznacz pole wyboru Komentarze żądania ściągnięcia, i następnie wybierz OK.

Po aktywowaniu komentarzy przełącz na dowolną gałąź z aktywnym pull requestem i kliknij przycisk Pokaż komentarze w plikach na pasku informacji. Przejdź przez zmiany, używając 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.

Wyświetlanie komentarzy w widoku różnic

Komentarze można wyświetlać w widoku różnic, a także w widoku plików. W widoku różnic można zobaczyć komentarze obok oryginalnego i zaktualizowanego kodu. Ułatwia to sprawdzanie, co zostało zmienione i dlaczego. Możesz również edytować plik roboczy bezpośrednio w tym widoku.

Zrób zrzut ekranu komentarza PR w widoku różnic.

Formatowanie języka Markdown w komentarzach

W widoku pliku lub widoku różnic komentarze są renderowane przy użyciu formatowania markdown.

Zrzut ekranu komentarza PR pokazującego formatowanie Markdown.

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ż