受信した GitHub プルリクエストをレビューする
プルリクエストは、オープンソースプロジェクトや一部の企業のワークフローで、コントリビュータからの変更を管理したり、変更がマージされる前にコードレビューを開始したりするために使用されます。
同僚やコントリビューターからコード変更のレビュー依頼が届くことがあります。 プルリクエストのレビュー担当者は、IntelliJ IDEA で直接フィードバックを提供できます：
プルリクエスト ツールウィンドウで、 保留中のレビュー依頼を選択します。
コメントや提案を送信します。
受信プルリクエストを管理する
プロジェクトのメンテナーであり、プロジェクト用に GitHub リモートが設定されている場合は、受信したプルリクエストを IntelliJ IDEA から直接表示および管理できます。
プルリクエスト ツールウィンドウを開くには、メインメニューから を選択します。},{
プルリクエスト ツールウィンドウでは、次のことができます。},{
状態別、作成者別、ラベル別、担当者別、レビューステータス別の リクエストのフィルター。
アクティビティのステータスに基づいて、プルリクエストを 並べ替えます。新しい順 、古い順、コメントが多い/少ない順、更新が新しい/古い順など。
GitHub でプルリクエストに移動する: プルリクエストを選択して、コンテキストメニューから プルリクエストをブラウザーで表示 を選択します。
一覧でプルリクエストをダブルクリックすると、概要タブとタイムラインタブが表示されます。},{
このビューでは、次のことができます。
選択したプルリクエストのタイムラインを 表示して、進行状況を追跡します。},{
特定のコミットを選択して、変更の一覧をフィルターします。
ローカルブランチを作成する: 相手からの変更を元にローカルブランチを作成するには、プルリクエストを開き、相手からの変更が含まれるブランチをクリックし、コンテキストメニューで チェックアウト「ブランチ名」 を選択します。
その他のオプションについて詳しく見るには、 プルリクエストを確認する を参照してください。
プルリクエストを確認する
注意が必要な変更がある場合、 プルリクエスト ツールウィンドウに白い点が表示され、表示されていないプルリクエストには青い点が表示されます。
メインメニューで へ移動します。
プルリクエストのリストで、操作するものを選択してダブルクリックします。
IntelliJ IDEA は、選択したプルリクエストの概要を開きます。
タイトルの横にプルリクエスト番号があります。 GitHub でプルリクエストを開きたい場合は、それをクリックします。
タイムラインの表示 をクリックすると、新しいタブが開き、プルリクエストの進行状況やプルリクエスト全体に関する高レベルのコメントが表示されます。
変更されたファイルのリストをフィルタリングするには、 からの変更点 で調査するコミットを選択します。
任意のファイルを右クリックして、このファイルのコンテキストメニューを開きます。
コメントや提案がある場合は、ファイルのリストにコメント数のカウンターが表示されます。
レビューを開始するには、相手からの変更があるブランチをクリックし、コンテキストメニューで チェックアウト「ブランチ名」 を選択します。
ブランチをチェックアウトすると、相手からの変更をテストして動作を確認するための完全なコンテキストが得られます。
チェックアウトが成功すると、IntelliJ IDEA は レビューモードを開始します。 つまり、ハイライトされた変更やコメントを、diff タブ（Ctrl+D ）だけでなく、エディター内（F4 ）でも確認できます。
調査するファイルを選択し、右クリックしてコンテキストメニューから ソースに移動 F4 を選択します。
開いたファイルでは、ガター内のピンク色のマーカーが、レビュー可能な変更とコメントを示します。
ガター内のコメントアイコンをクリックすると、コメントが非表示になったり開いたりします。
ピンクのマーカーをクリックすると、元のコードを表示するポップアップが表示されます。
ガターの上にマウスを移動し、
をクリックしてコメントを残します。
すぐにコメントを投稿し、他のレビュー担当者に通知するには、 単一コメントの追加 を選択してください。
複数のコメントを追加するには、 レビューの開始 を選択します。
レビューを送信する前に、コメントに 保留 のマークが付けられ、編集または削除することができます。
複数行にコメントするには、
をクリックして青い枠をドラッグし、目的の範囲を選択するか、先にテキストをハイライトしてから をクリックしてください。提案については、言語として
suggestionを指定して、Markdown コードブロックでラップされたコードのバージョンを追加してください。```suggestion Your suggestion for this code line ```上部のツールバーにある
/
を使用するか、 Ctrl+Alt+Up/Ctrl+Alt+Down を押して、コメント間を移動します。レビューを終了する準備ができたら、プルリクエストの概要で サブミット をクリックします。
または、VCS ウィジェットを開いて、 レビューの送信 をクリックします。
考えられる結果の 1 つを選択します。
承認する: マージする変更を承認します。
変更のリクエスト: フィードバックを送信するには、プルリクエストの作成者は、マージする前に提案された変更を適用する必要があります。
コメント: 承認なしにコメントを送信すること。
受信したプルリクエストをマージまたはクローズする
リポジトリへのプッシュ権限がある場合は、レビューを送信し、すべての課題を解決した後に、プルリクエストをマージするかクローズできます。
メインメニューで へ移動します。
プルリクエストのリストで、操作するものを選択してダブルクリックします。
概要の下部には、レビュープロセスの段階やプッシュ権限に応じて異なるマージオプションのボタンがあります。}]} } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } } }}} } } } } } } }}
レビュー後に更新を承認した場合は、 マージ をクリックしてプルリクエストをマージできます。
その他のマージオプションについては、
をクリックし、 スカッシュとマージ を選択して変更を含むコミットを 1 つにまとめ、その後マージするか、 リベース を選択してプルリクエストブランチからのコミットをリベースし、ベースブランチに追加します。
詳細 をクリックし、このプルリクエストについて別の意見が必要な場合は レビューのリクエスト を選択し、マージしない場合は プルリクエストを閉じる を選択します。レビューを送信せずにプルリクエストをマージする準備ができたら、プルリクエストの概要で
をクリックし、 マージ、 スカッシュとマージ 、または リベース を選択します。
プルリクエストがマージされると、プルリクエストのタイムライン付きタブでマージされたブランチを削除できます。
必要に応じて、削除後に同じタイムライン表示に表示されるブラウザーリンクを使用して、削除したブランチを復元できます。