GITHUB_BASE_REF とは？

GITHUB_BASE_REF はプルリクエストのマージ先となるベース（ターゲット）ブランチで、pull_request イベントでのみ設定されます。

GITHUB_BASE_REF は PR ワークフローに対して変更がどこへ向かうのかを伝えます。これはベースブランチに対する diff の計算や、ブランチ固有のルールの適用に役立ちます。

一般的な用途

• 変更されたファイルをベースブランチに対して diff する
• main への PR に対してより厳格なチェックを適用する
• PR の完全なコンテキストのために GITHUB_HEAD_REF と組み合わせる

注記

ベースに対する diff の計算には通常、完全な履歴が必要なので、actions/checkout で fetch-depth: 0 を設定してください。

重要なポイント

• GITHUB_BASE_REF は PR のターゲットブランチです。
• pull_request イベントでのみ設定されます。
• それに対して diff を取るには fetch-depth: 0 が必要です。

関連ガイド