GitHub diff確認の基本
diff確認は、公開前やPR前に最も大事な作業のひとつです。本文の変更だけでなく、タグ、設定ファイル、画像、生成物、Secretsの混入も同時に確認します。
このページでわかること
- 変更ファイル一覧を見る
- 追加行と削除行を読む
- Secrets、ローカルパス、保護タグの変更を探す
まず確認すること
- title、description、H1、canonical、robotsの意図しない変更を見る
- AdSenseやSearch Consoleタグの差分がないか見る
- robots.txt、ads.txt、.htaccessなどが混ざっていないか見る
やってはいけないこと
- 大きすぎるdiffを読まずに進める
- 生成物の大量差分を本文変更と混ぜる
- 危険な断定表現や公式誤認表現を見落とす
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さなbranchとPRに分け、CIとreviewで確認する。
CodexやAI作業時の注意
AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。
公式情報で確認する領域
Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。
PRの比較元と二点・三点比較の違い
2026年11月18日時点の公式ヘルプでは、GitHubのPull Requestは三点比較の差分を表示すると説明されています。git diff A...Bの比較対象は、両ブランチの直近の共通祖先であるmerge baseと、作業ブランチBの先端です。一方、git diff A..BはAとBの先端同士を比較するため、基準ブランチが進むと、作業ブランチを編集していなくても表示内容が変わります。
三点比較が示すのは、分岐後に作業ブランチへ入った変更です。基準ブランチの現在の内容と作業ブランチ全体の違いを読む二点比較とは、問いが異なります。GitHub Docsは、基準ブランチを作業ブランチへ取り込むと、二点比較と三点比較の差分が同じになることも説明しています。PR画面と手元の比較が食い違う場合には、比較方法に加えて、どのcommitを基準にしているかが確認対象です。
出典:GitHub『Branches』(2026年11月18日確認)https://docs.github.com/en/pull-requests/reference/branches
未ステージ・ステージ済みの差分を分けて読む
2026年11月18日時点の公式ヘルプでは、引数を付けないgit diffは作業ツリーとindexの差を表示するコマンドです。git diff --cachedはindexとHEADの差を表示し、次のcommitへ入るステージ済みの変更を読めます。git diff HEADはHEADと作業ツリーを比較するため、ステージ済みかどうかで区切らず、追跡中のファイルの変更を確認する形です。
ファイル名を絞る場合は、git diff -- パスのように区切りを入れられます。--name-onlyは変更したファイル名、--name-statusは名前と変更種別、--statは差分の統計を表示する選択肢です。本文を読む前の一覧と行単位の差分は役割が異なり、一覧だけでは具体的な書き換え内容までは表せません。公式文書の--checkは、競合マーカーや空白の誤りを警告する指定で、記事の意味や設定値の正しさを判定するものではありません。
出典:Git『git-diff』(2026年11月18日確認)https://git-scm.com/docs/git-diff
Files changedの表示と閲覧済みの扱い
2026年11月18日時点の公式ヘルプでは、Files changedで差分を一列のunified表示と左右に分けるsplit表示に切り替えられます。空白の差を隠す設定や、対象ファイルの絞り込みも用意されています。空白を隠す選択はそのPRに対して適用され、同じページを開き直した際にも保持される説明です。表示の選び方によって、画面で目に入る差分の範囲が変わります。
ファイルをViewedにすると内容を折りたたみ、ヘッダーの進捗表示で閲覧済みの数を追えます。その後にファイルが変更された場合は、閲覧済みの印が外れる仕組みです。また、レビューを送信する前の行コメントは作成者だけに見える状態に置かれます。差分を読んだ記録、コメントの入力、レビューの提出は、それぞれ別の状態として説明されています。
依存関係のmanifestやlockfileには、rich diffからdependency reviewを開く機能もあります。公式は、依存関係を変えないファイル編集や、GitHubが解析できない依存関係はその表示へ出ない場合があるため、ソースの差分も確認するよう案内しています。依存関係用の表示で見える項目と、ファイルに加えたすべての変更は範囲が異なります。
出典:GitHub『Reviewing proposed changes in a pull request』(2026年11月18日確認)https://docs.github.com/en/pull-requests/how-tos/review-pull-requests/reviewing-proposed-changes-in-a-pull-request
生成ファイルが差分で折りたたまれる理由
2026年11月18日時点の公式ヘルプでは、.gitattributesのlinguist-generated属性で、指定したファイルを生成物として扱えます。この属性が付いたファイルは差分で既定では隠れ、リポジトリの言語統計からも除外されます。差分の表示を制御する属性であり、対象ファイルをGitの管理から取り除く設定ではありません。
公式の例ではsearch/index.jsonにlinguist-generatedを付ける指定と、通常は生成物と判定されるbootstrap.min.cssへ-linguist-generatedを付けて解除する指定が示されています。パターンには.gitignoreと同じ照合規則が使われます。変更ファイルの一覧にあるのに本文の差分がすぐ見えない場合は、こうした属性による既定表示も確認箇所です。
出典:GitHub『Customizing how changed files appear on GitHub』(2026年11月18日確認)https://docs.github.com/en/repositories/working-with-files/managing-files/customizing-how-changed-files-appear-on-github