プルリクエストとチーム開発の流れ
プルリクエスト(PR)とは
「このブランチの変更を main に取り込んでください」という依頼 です。GitHub の機能で、Git 自体のコマンドではありません(GitLab では「マージリクエスト」と呼びます)。
PR を開くと、GitHub 上に次のものが並びます。
- ブランチ間の 差分(何を変えたか)
- 説明文(なぜ変えたか)
- レビューコメント(他のメンバーからの指摘・質問・承認)
- マージボタン
なぜ main に直接 push しないのか
1 人で使っているなら直接 push でも困りません。チームでは次の理由で PR を挟みます。
- レビュー — 他人の目が入ると、バグ・設計ミス・読みにくさが早く見つかる。書いた本人は気づけない
- 記録 — 「なぜこう変えたのか」の議論が PR に残る。半年後に読み返せる
- 安全 — main を「常に動く状態」に保てる。GitHub の設定で main への直接 push を禁止できる
- 自動チェック — PR にテストや静的解析を自動で走らせ、通らなければマージできないようにできる
GitHub Flow
もっともシンプルで広く使われている流れです。
main ──●──────────────────●── (マージ) ──●──
\ /
●──●──●──●──●── feature/xxx ← PR- main を最新にする —
git switch main && git pull - ブランチを切る —
git switch -c feature/xxx - コミットを積む — 小さく、意味のある単位で
- push する —
git push -u origin feature/xxx - PR を作る — GitHub で「New pull request」。タイトルと説明を書く
- レビューを受ける — 指摘があれば 同じブランチに push。PR は自動で更新される
- マージする — 承認されたら「Merge pull request」。リモートの main が進む
- 後片付け —
git switch main && git pull、ブランチ削除
良い PR の書き方
タイトル
「何をしたか」が一目で分かるように。
- ○
ログイン画面にパスワード表示ボタンを追加 - ✗
修正更新作業中
説明文
レビュアーが読む前提で、次を書きます。
- 何を 変えたか(概要)
- なぜ 変えたか(背景・課題・Issue 番号)
- どう確認したか(動作確認の手順、スクリーンショット)
- 特に見てほしいところ、迷っているところ
大きさ
小さい PR ほどレビューされやすく、早くマージされます。 目安は差分 300 行以下。大きくなりそうなら、分割できないか考えます。
レビューする側の心得
- 人ではなくコードを見る。「なぜこうしたのですか?」と 質問の形 で
- 直してほしいこと(must)と好みの提案(nice to have)を区別する
- 良いところも書く
- 早く返す。レビュー待ちは全体の速度を落とす
PR を出したあとの更新
レビューで指摘を受けたら、修正して 同じブランチに push するだけ です。
# 指摘を直す
git commit -am "レビュー対応: エラーメッセージを修正"
git pushPR を作り直す必要はありません。
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 が自動で閉じます。
手を動かして確かめる
このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。