【ぷるりくえすと】

プルリクエスト とは?

最終更新:
💡 変更の取り込みを提案し、差分を確認する場

ブランチの変更を別のブランチへ取り込む提案を出し、差分の確認・議論・レビューなどを進める仕組み。GitHubではPull Requestと呼ぶ。作成だけで変更が統合されたり、品質が保証されたりするわけではない。

📌 このページのポイント
PR:変更の取り込みを提案 取り込み先 変更のブランチ PR 統合 差分・説明 確認・相談 検査結果 レビュー 必須の承認や検査はルールで設定 作成だけで統合や品質は保証されない
ブランチから別ブランチへの取り込みを提案し、差分・レビュー・検査結果を確認する例。取り込み先はmainに限らず、統合せず閉じる場合もある。Draft PRはマージできない。
ひよこ ひよこ
PRを作ると、コードがマージされるの?
ペンギン先生 ペンギン先生
作成は変更の提案だよ。差分や説明を見て、コメントやレビュー、検査結果をもとに取り込むか判断する。取り込み先はmain以外のブランチにもできるし、マージせずに閉じることもあるんだ。
ひよこ ひよこ
レビューやテストは必ず必要なの?
ペンギン先生 ペンギン先生
PRという仕組みだけで必須になるわけではないよ。GitHubではブランチ保護などで承認や特定の検査を必須にできる。ルールを満たしても、見ていない不具合までなくなる保証ではない。GitLabでは似た提案の場をMerge Requestと呼ぶよ。
ひよこ ひよこ
分かりやすいPRを書くには?
ペンギン先生 ペンギン先生
一つの目的に絞り、必要に応じて分けよう。タイトルと説明には、なぜ必要か、何が変わるか、どこを見てほしいか、どう確認したかを書く。画面の変更なら画像も役立つ。300行以内などの決まった数を、どの変更にも当てはめる必要はないんだ。
ひよこ ひよこ
レビューでは何を確認するの?
ペンギン先生 ペンギン先生
変更の目的に対して、ロジックや境界条件、読みやすさ、必要なテスト、影響を確認するよ。認証や権限、依存パッケージなどの変更では安全性も大切。承認はレビューした範囲での判断で、全ての問題がないという証明ではないんだ。
ひよこ ひよこ
マージできない場合や、まだ作業中の場合は?
ペンギン先生 ペンギン先生
マージ欄で理由を確認しよう。競合、必要な承認や検査、未解決の会話、権限など複数の条件が関係する。GitHubのDraft PRは作業途中の共有に使え、マージできない。準備ができたらレビュー可能な状態へ切り替えるんだ。
ペンギン
まとめ:ざっくりこれだけ覚えればOK!
「プルリクエスト」って出てきたら「変更の取り込みを提案して、差分を確認・相談する仕組み」と思えばだいたいOK!
📖 おまけ:英語の意味
「Pull Request」 = 変更の取り込みを依頼すること
💬 自分のブランチの変更を取り込み先のブランチへ取り込んでほしい、という提案だよ。取り込み先が必ずmainというわけではないんだ。

参考資料

← 用語集にもどる