GitHub または Azure DevOps に対して認証され、変更をリモート リポジトリにプッシュした場合は、Visual Studio を終了せずに pull request を作成できます。 プル要求は、GitHub と Azure DevOps のコード レビューに不可欠なツールです。 これらのレビューは、新機能の問題をキャッチし、チームメイトがコードベースのさまざまなリージョンで自分の経験を共有し、コードベース全体の正常性を向上させるのに役立ちます。
pull request を作成するには、次の手順に従います。
pull request を作成する前に、変更用の新しいブランチ を 作成する必要があります。 このブランチは、マージの準備ができるまで、変更をメイン ブランチとは別に保持します。
通知バナーのリンクを選んで、[Visual Studio で作成] または [ブラウザーで作成] を選びます。
または、Git トップレベル メニューから New Pull Request ウィンドウに移動して、リモート ブランチからプル要求を作成することもできます。 または、Git リポジトリ ウィンドウでブランチを右クリックします。
または、Git リポジトリ ウィンドウでブランチを右選択してコンテキスト メニューを開き、新しいプル要求 選択します。
pull request を作成しようとしても、キーチェーンに複数のアカウントがある場合は、使用するアカウントを求めるプロンプトが表示されます。 キーチェーンへの GitHub アカウントの追加を参照してください。
マージするブランチを選択し、pull request にわかりやすいタイトルと説明を付けます。 マークダウン構文 を使用して、Visual Studio から pull request の説明を書式設定できます。 [説明] ボックスにマークダウン記号を入力して試し、[プレビュー] ボタンを選択してマークダウンをプレビューします。
ヒント
Visual Studio 2022 バージョン 17.10 以降と GitHub Copilot 拡張機能を使用すると、AI を使用して、変更を説明する詳細なプル要求の説明を生成できます。 スパークル ペン アイコンを押して、GitHub Copilot に PR の説明を生成するよう要求します。 GitHub Copilot をインストールするには、「Visual Studioでの GitHub Copilot のインストールと管理」を参照してください。
差分プレビューを使用すると、プル要求の一部としてコミットされたファイル内のすべての変更を確認できます。 「ファイルの比較 - 差分ビューを参照してください。
ヒント
概要差分ビュー オプションを使用すると、コードの変更されたセクションのみを確認できます。
作業項目を 問題検索で参照するか、説明ボックスに「
#」と入力するか、右下隅の # ボタンを押すと、作業項目をリンクできます。 GitHub ユーザー名または Azure DevOps ID または電子メールを入力して、レビュー担当者を追加することもできます。
プルリクエストで[作成]をクリックすると、他の開発者が変更内容を確認し、フィードバックを提供することができます。 または、Visual Studio 17.12 以降でドロップダウンをクリックし、[下書きとして作成] を選択。
pull request テンプレートをリポジトリに追加する方法の詳細については、GitHub ドキュメント および Azure DevOps ドキュメント 参照してください。
エディターで pull request コメントを表示または追加する
Visual Studio 17.11 以降では、コンテキストをブラウザーに切り替えることなく、レビュー担当者からのコメントや提案を表示できます。
この機能を有効にするには、[ツール>オプション] ウィンドウを開き>プレビュー機能] セクションを展開し、[Pull Request Comments]\(プル要求コメント\) チェック ボックスをオンにします。
この機能を有効にするには、[ ツール>オプション ] ダイアログを開き、[ 環境>プレビュー機能 ] セクションを展開します。 プルリクエストコメント チェックボックスを選び、OK を選択します。
プルリクエストのコメントを表示する
pull request のコメントを表示するには、アクティブな pull request ブランチがあるブランチをチェックアウトし、情報バーから ファイルにコメントを表示する を選択します。 Git Changes ウィンドウで PR 番号を選択することも、Git トップレベル メニューから Git>GitHub や Azure DevOps >ファイルにコメントを表示することもできます。
プルリクエストコメントを追加する
Visual Studio 17.13 以降では、pull request を確認したり、コメントを追加したりできます。 この機能を有効にするには、[ツール>オプション] ウィンドウを開き>プレビュー機能] セクションを展開し、[Pull Request Comments]\(プル要求コメント\) チェック ボックスをオンにします。
Visual Studio 17.13 以降では、pull request を確認したり、コメントを追加したりできます。 この機能を有効にするには、[ ツール>オプション ] ダイアログを開き、[ 環境>プレビュー機能 ] セクションを展開します。 [Pull Request Comments] チェックボックスをオンにし、[OK] を選択します。
コメントをアクティブにした後、アクティブなプル要求があるブランチをチェックアウトし、情報バー のファイルにコメントを表示 するをクリックします。 コード ファイルの上にあるツール バー ボタンを使用して、変更を移動します。
コメントを追加するには、次のスクリーンショットに示すように、エディターの左側にある [コメントの追加] アイコンをクリックします。
コード行を右クリックし、コンテキスト メニューの [Git] >の追加]選択することもできます。
コメント テキストは、コメント ウィンドウの [ コメントの追加 ] ボタンをクリックするまで発行されません。
コメント ボックスの [返信] セクションを使用して、既存のコメントの会話を続けることができます。 コメントはアクティブか解決済みのいずれかです。 [返信 解決] をクリックしてコメントに返信し、1 回のクリックで状態を解決済みに変更したり、コメント テキストの上にあるドロップダウンを使用して状態を変更したりできます。
アイコンをクリックするか、3 つのドットをクリックしてコメントの状態を切り替えることができます。コメント テキストをクリップボードにコピーしたり、コメントへのリンクをクリップボードにコピーしたり、コメントを削除したり、プロバイダーのサイト (github.com や Azure DevOps プロジェクト サイトなど) で Web ブラウザーでコメントを開いたりすることができます。
pull request にコメントを追加する機能は、一部の Git プロバイダーに制限されています。 たとえば、GitHub をプロバイダーとして使用すると、変更の 3 行以内の行にのみコメントを追加できますが、Azure DevOps プロバイダーでは、pull request に関係するファイルの任意の行にコメントを追加できます。 いずれの場合も、pull request に含まれるファイルにのみコメントを追加できます。
差分ビューでコメントを表示する
差分ビューとファイル ビューでコメントを表示できます。 差分ビューでは、元のコードと更新されたコードと共にコメントを表示できます。 これにより、変更された内容とその理由を正確に確認しやすくなります。 このビューで作業ファイルを直接編集することもできます。
コメント内のマークダウンの書式設定
ファイル ビューまたは差分ビューでは、コメントは Markdown 形式を使用してレンダリングされます。
キーボードを使用する
ツール バーのアイコンを使用して、ファイルや個々のコメント間を移動したり、次のキーボード ショートカットを使用したりできます。
| アクション | キーボード ショートカット |
|---|---|
| pull request の前のファイルに移動する | + Alt+F6 |
| pull request の次のファイルに移動します | + + |
| 前のコメントに移動する | + Alt+F8 |
| 次のコメントに移動する | + + |
| ファイル内のコメントを非表示にする | + F1 |
次の手順
作業を続けるには、「Visual Studio でのフェッチ、プルおよび同期」ページを参照してください。