$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

プルリクエストとチーム開発の流れ

プルリクエスト(PR)とは

「このブランチの変更を main に取り込んでください」という依頼 です。GitHub の機能で、Git 自体のコマンドではありません(GitLab では「マージリクエスト」と呼びます)。

PR を開くと、GitHub 上に次のものが並びます。

  • ブランチ間の 差分(何を変えたか)
  • 説明文(なぜ変えたか)
  • レビューコメント(他のメンバーからの指摘・質問・承認)
  • マージボタン

なぜ main に直接 push しないのか

1 人で使っているなら直接 push でも困りません。チームでは次の理由で PR を挟みます。

  • レビュー — 他人の目が入ると、バグ・設計ミス・読みにくさが早く見つかる。書いた本人は気づけない
  • 記録 — 「なぜこう変えたのか」の議論が PR に残る。半年後に読み返せる
  • 安全 — main を「常に動く状態」に保てる。GitHub の設定で main への直接 push を禁止できる
  • 自動チェック — PR にテストや静的解析を自動で走らせ、通らなければマージできないようにできる

GitHub Flow

もっともシンプルで広く使われている流れです。

main ──●──────────────────●── (マージ) ──●──
        \                /
         ●──●──●──●──●──   feature/xxx  ← PR
  1. main を最新にする — git switch main && git pull
  2. ブランチを切る — git switch -c feature/xxx
  3. コミットを積む — 小さく、意味のある単位で
  4. push する — git push -u origin feature/xxx
  5. PR を作る — GitHub で「New pull request」。タイトルと説明を書く
  6. レビューを受ける — 指摘があれば 同じブランチに push。PR は自動で更新される
  7. マージする — 承認されたら「Merge pull request」。リモートの main が進む
  8. 後片付け — git switch main && git pull、ブランチ削除

良い PR の書き方

タイトル

「何をしたか」が一目で分かるように。

  • ○ ログイン画面にパスワード表示ボタンを追加
  • ✗ 修正 更新 作業中

説明文

レビュアーが読む前提で、次を書きます。

  • 何を 変えたか(概要)
  • なぜ 変えたか(背景・課題・Issue 番号)
  • どう確認したか(動作確認の手順、スクリーンショット)
  • 特に見てほしいところ、迷っているところ

大きさ

小さい PR ほどレビューされやすく、早くマージされます。 目安は差分 300 行以下。大きくなりそうなら、分割できないか考えます。

レビューする側の心得

  • 人ではなくコードを見る。「なぜこうしたのですか?」と 質問の形 で
  • 直してほしいこと(must)と好みの提案(nice to have)を区別する
  • 良いところも書く
  • 早く返す。レビュー待ちは全体の速度を落とす

PR を出したあとの更新

レビューで指摘を受けたら、修正して 同じブランチに push するだけ です。

# 指摘を直す
git commit -am "レビュー対応: エラーメッセージを修正"
git push

PR を作り直す必要はありません。

main が先に進んでしまったら

PR を出している間に、他の人の PR が main にマージされることがあります。コンフリクトがなければそのままマージできます。コンフリクトがあれば、自分のブランチに main を取り込んで解消します。

git switch feature/xxx
git pull origin main        # main の変更を取り込む(コンフリクトがあれば解消)
git push

本物の Git では、分岐した状態の pull は pull.rebase の設定がないと止まります。リモートリポジトリ の「push が rejected される」を参照してください(git pull --no-rebase origin main と明示しても同じ結果になります)。

またはチームのルールによっては rebase で整えます。

git fetch
git rebase origin/main
git push --force-with-lease   # 自分のブランチなので force してよい

マージの種類(GitHub のボタン)

方式何が起きるか履歴
Merge commitマージコミットを作る(--no-ff)分岐と合流が残る
Squash and mergeブランチの全コミットを 1 つにまとめて main に載せるmain は 1 コミット増えるだけ。きれい
Rebase and mergeコミットを main の上に積み直す一直線

どれを使うかはチームのルールです。迷ったら聞きましょう。

Issue との関係

GitHub の Issue は「やること・バグ・相談」を書くチケットです。多くのチームでは、

Issue #12 「ログインできない」
   ↓
ブランチ fix/login-error
   ↓
PR 「ログインエラーを修正 (closes #12)」

のように、Issue → ブランチ → PR の順で仕事が流れます。PR の説明に closes #12 と書くと、マージ時に Issue が自動で閉じます。

手を動かして確かめる

このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。