プルリクエスト（Pull Request）とは、Gitを使った開発において、自分が変更したコードを本流のブランチに取り込んでもらうよう依頼する仕組みのことです。GitHubやGitLabなどのサービスで広く使われており、略して「PR」と呼ばれることもあります。なお、GitLabでは同じ仕組みを「マージリクエスト（Merge Request）」と呼び、「MR」と略されます。
イメージとしては、プルリクエストは原稿の校正依頼のようなものです。自分で書いた原稿を、いきなり本の完成版に差し込むのではなく、編集者にチェックしてもらってから、正式に採用してもらう流れに似ています。
プルリクエスト図解
※画像をクリックすると拡大表示します。
プルリクエストとは
プルリクエストは、開発者が自分のブランチ（作業用の分岐）で行った変更内容を、他のメンバーに確認してもらったうえで、メインのブランチに取り込む（マージする）ための依頼機能です。「変更を取り込んでください（Pull）」という依頼（Request）という名前の通り、コードの変更を提案する手段として使われます。
プルリクエストが生まれた背景
複数人でコードを共同開発する場合、誰かが確認しないまま変更を本流に反映してしまうと、バグの見落としや意図しない不具合が起きやすくなります。プルリクエストの仕組みは、変更を取り込む前に必ず第三者がチェックするプロセスを設けることで、こうしたリスクを減らすために広まりました。
プルリクエストの基本的な流れ
まず開発者は、変更用のブランチを作成してコードを修正・コミットします。作業が終わったら、そのブランチの内容をメインのブランチに取り込んでほしいと、プルリクエストを作成します。他のメンバーが変更内容を確認し、問題がなければ承認され、メインのブランチに反映されます。
コードレビューとの関係
プルリクエストが作成されると、他の開発者が変更内容を読み、改善点や疑問点があればコメントを残します。この確認作業をコードレビューと呼び、プルリクエストはコードレビューを行うための土台としての役割も担っています。指摘があれば修正して再度提出し、承認されるまでこのやり取りを繰り返します。
プルリクエストのメリット
プルリクエストを使うことで、コードの品質チェックが仕組みとして組み込まれ、バグの早期発見や知識の共有につながります。また、誰がどのような変更をいつ行ったかという履歴が明確に残るため、後から経緯を追いやすくなる点も大きな利点です。
プルリクエストに書く内容
プルリクエストには通常、変更の目的や概要、修正した理由、動作確認の方法などを記載します。わかりやすい説明を添えることで、レビューする側が変更内容を把握しやすくなり、確認や承認までの時間を短縮できます。
マージとの違い
プルリクエストは「変更を取り込んでほしい」という依頼・提案の段階を指し、実際に変更をメインのブランチへ反映する操作をマージと呼びます。プルリクエストが承認されて初めて、マージが行われるという順序になります。
プルリクエストを使う場面
プルリクエストは、複数人で進めるチーム開発はもちろん、オープンソースプロジェクトへの貢献でもよく使われます。外部の開発者が改善提案としてプルリクエストを送り、プロジェクトの管理者が内容を確認して取り込むかどうかを判断する、という使われ方も一般的です。
| 用語 | 意味 | 補足 |
|---|---|---|
| プルリクエスト | 変更の取り込みを依頼すること | 略して「PR」とも呼ばれる |
| コードレビュー | 変更内容を第三者が確認すること | プルリクエスト上で行われる |
| マージ | 変更をメインのブランチに反映すること | プルリクエスト承認後に行う操作 |
コメント