プルリクエスト中でのブランチの比較について

注: pull request を作成する際に、変更の比較対象となるベースブランチを変更できます。詳細については、「プルリクエストの作成方法」を参照してく� さい。

pull request 内で提案された変更は、[Files changed](変更されたファイル) タブで表示できます。 pull request の [Files changed](変更されたファイル) タブ

コミットそのものを見るよりは、プルリクエストがマージされた際に提案された変更がファイルに現れるのを見ることができます。 [Files changed](変更されたファイル) タブではファイルはアルファベット� �に表示されます。追� したファイルは緑色になり + 記号が前に付きます。一方、削除したコンテンツは赤色になり、- 記号が前に付きます。

diff 表示の選択肢

ヒント: 変更のコンテキストを理解するのが難しい� �合は、[Files changed](変更されたファイル) タブの [View](表示) をクリックすると、提案された変更を含むファイル全体が表示されます。

diff の見方には複数の選択肢があります。

統合ビューでは、更新分と既存の内容が線形ビューに一緒に表示されます。
分割ビューでは、古い内容が片側に、新しい内容が反対側に表示されます。
リッチ diff ビューでは、プルリクエストがマージされたときに変更がどのように見えるかのプレビューが表示されます。
ソースビューでは、ソース内の変更がリッチ diff ビューのフォーマットなしで表示されます。

プルリクエスト中の大きな変更をもっと正確に表示するために、空白の変更を無視するよう選択することもできます。

大規模なプルリクエスト中の変更のレビューを簡� 化するために、選択されたファイルタイプ� けを表示、CODEOWNERS であるファイルを表示、表示したことのあるファイルを非表示、または削除されたファイルを非表示にするように diff をフィルタリングできます。詳細については、「pull request 内のファイルをファイルの種類でフィルター処理する」を参照してく� さい。

diffが表示されない理由

ファイルあるいは特定のファイルタイプの合計での制限を超えた。詳細については、リポジトリに関する説明を参照してく� さい。
ファイルが、リポジトリの .gitattributes ファイルの規則と一致した (既定でファイルの表示がブロックされます)。詳細については、「変更したファイルの GitHub での表示方法をカスタマイズする」を参照してく� さい。

スリードットおよびツードット Git diff での比較

git diff コマンドには、ツードット (git diff A..B) とスリードット (git diff A...B) という 2 つの比較方法があります。既定では、GitHub に対する pull request ではスリードットの差分が表示されます。

スリードット Git 差分の比較

スリードット比較では、両方のブランチ (マージベース) の最新共通コミットとトピックブランチの最新バージョンの差分が表示されます。

ツードット Git 差分の比較

ツードット比較では、ベースブランチ (main など) の最新状態とトピックブランチの最新バージョンの差分が表示されます。

GitHub 上で、ツードット diff を比較する際に 2 つの committish のリファレンスを見たい� �合には、リポジトリの [Comparing changes] ページの URL を編集できます。詳細については、Pro Git ブックサイトで Git 用語集の「committish」を参照してく� さい。

たとえば、この URL では、短縮された 7 文字の SHA コードを使用してコミットと c3a414e faf7c6f を比較します (https://github.com/github/linguist/compare/c3a414e..faf7c6f)。

ツードット diff は SHA あるいは OID (Object ID) など、2 つの Git の committish 参照を直接互いに比較します。 GitHub では、ツードット diff での比較中の Git の committish 参照は、同じリポジトリあるいはそのフォークにプッシュされなければなりません。

プルリクエスト中でツードット diff をシミュレートし、各ブランチの最新バージョン同士の比較を見たい� �合には、ベースブランチをトピックブランチにマージできます。そうすれば、ブランチ間の最後の共通の祖先が更新されます。

変更を比較するための Git コマンドの詳細については、Pro Git ブックサイトの「git 差分オプション」を参照してく� さい。

GitHub でのスリードット比較について

スリードット比較はマージベースと比較するため、"pull request によって何が導入されるか" に焦点を当てています。

ツードット比較を使用したときは、トピックブランチに変更を� えていない� �合でも、ベースブランチが更新されると差分が変化します。また、ツードット比較はベースブランチに焦点を当てます。つまり、追� したものは、ベースブランチに存在しないものとして (削除されたかのように) 表示されます。その逆も同様です。その結果、トピックブランチが導入する変更があいまいになります。

対照的に、スリードット比較を使用してブランチを比較すると、ベースブランチが更新された� �合、トピックブランチの変更は常に差分に含まれます。この差分には、ブランチが分岐してからのすべての変更が表示されるためです。

� �繁なマージ

混乱を避けるためには、ベースブランチ (たとえば main) をトピックブランチに� �繁にマージします。ベースブランチをマージすることで、ツードット比較とスリードット比較で示される差分が同じになります。できる� け早く pull request をマージすることをお勧めします。このために共同作成者が pull request を小さく作成することが促されます。これは一般的に推奨されます。

参考資料

"プルリクエストについて"
「About forks」 (フォークの概要)