Git・GitHubのブランチ運用入門|プルリクエスト・マージ・コンフリクト解決の手順
「ブランチを作る理由がわからない」「pushとマージの違いが曖昧」「コンフリクトが出ると、どちらを残せばよいか迷う」。GitやGitHubを使い始めると、コマンドを覚えるだけでは判断しにくい場面に出会います。
基本となるのは、変更する場所を分け、差分を確認して記録し、内容を確かめてから統合する流れです。それぞれの操作が、手元のファイル・履歴・GitHubのどこに作用するのかを整理すると、作業を追いやすくなります。
この記事では、作業用ブランチの作成からプルリクエスト、マージ、コンフリクト解決までを説明します。コマンドは順番だけで暗記せず、実行前後の状態も確認していきましょう。
目次
1.GitとGitHub、ブランチの役割を整理する
Gitは、ファイルの変更履歴を管理するためのツールです。GitHubは、Gitのリポジトリを共有し、変更内容のレビューや共同作業などを行うサービスです。Git自体は、GitHubに接続していない状態でも利用できます。
ブランチは、変更履歴を分けて作業するための仕組みです。たとえば、公開中のページに関する履歴を維持しながら、別のブランチで新しい申し込みフォームを開発できます。
| 用語 | 役割 |
|---|---|
| リポジトリ | ファイルと変更履歴を管理する単位 |
| ブランチ | 変更履歴を分けて作業するための仕組み |
| ステージング | 次のコミットに含める変更を選ぶ操作 |
| コミット | 選択した変更をローカルの履歴に記録する操作 |
| push | ローカルのコミットをリモートへ送る操作 |
| プルリクエスト | 変更の統合を提案し、レビューするためのGitHubの機能 |
| マージ | 別のブランチの変更履歴を統合する操作 |
mainが必ず本番環境というわけではない
mainは、主要なブランチ名として使われることがあります。ただし、mainへの変更がそのまま本番環境へ反映されるかどうかは、デプロイの設定や運用ルールによって異なります。
作業前に「どのブランチから開発を始めるか」「どこへ統合するか」「何をきっかけに公開されるか」を確認しましょう。ブランチを分けただけで、共有データベースなど外部環境への影響まで防げるわけではありません。
2.作業前に、現在のブランチと変更状態を確認する
以下の例は、Gitがインストールされ、GitHubのリポジトリを手元にclone済みであることを前提にしています。リモート名はorigin、作業の基点はmainとします。実際のプロジェクトで名前が異なる場合は読み替えてください。
まず、リポジトリのフォルダで次のコマンドを実行します。この記事のコマンド例は説明用であり、ご自身のリポジトリでの実行確認は行っていません。
git statusでは、変更したファイル、ステージング済みの変更、未追跡ファイルなどを確認できます。git branch –show-currentでは、現在のブランチ名を確認できます。
作業途中の変更がある場合は、その内容を確認してから次へ進みます。必要な変更を適切なブランチでコミットする、別の場所へ控えを残すなど、変更の扱いを決めてください。エラーを消すためだけに変更を破棄する操作は行いません。
mainを更新してから作業用ブランチを作る
ここでは、未コミットの変更がなく、マージなどの途中でもない状態から始めます。mainに切り替えたことを確認してから、リモートのmainを取り込みます。
各コマンドが成功したことを確認してから、次を実行してください。特に、git switch mainが失敗したままpullを実行しないようにします。
git pull origin mainは、常にローカルのmainを更新する命令ではありません。取得したmainの変更を、現在いるブランチへ取り込む操作です。作業用ブランチ上で実行すると、そのブランチに影響します。
この例の–ff-onlyは、履歴が分岐していて単純に先へ進められない場合に処理を停止します。停止したら、ローカルだけにあるコミットなどを確認し、原因を理解せず強制的な更新へ切り替えないようにしましょう。
3.差分を確認してコミットし、GitHubへ送る
ここでは、問い合わせフォームを作るためにindex.htmlとstyle.cssを編集したとします。変更後は、保存したファイル名だけでなく、実際にどの行が変わったかも確認します。
通常のgit diffは、主にステージングしていない追跡済みファイルの差分を表示します。新しく作った未追跡ファイルの内容は、この表示だけでは確認できないため、ファイル自体も開いて確認してください。
内容を確認したら、コミットに含めたいファイルを指定します。次のファイル名は例なので、自分が変更したファイルに置き換えます。
git diff –stagedでは、次のコミットに含まれる差分を確認できます。無関係な修正、APIキー、個人情報、不要な生成ファイルなどが混ざっていないか見直しましょう。
git add .でまとめて追加する方法もありますが、対象を確認せず使うと、意図しないファイルまで含める場合があります。慣れるまでは、ファイル名を指定する方法から始めると確認しやすくなります。
コミットは手元の履歴への記録で、pushはリモートへの送信です。コミットしただけではGitHubには反映されず、作業用ブランチをpushしただけではmainへ統合されません。
また、ステージング後にファイルを再編集した場合、その追加の編集は自動で同じコミットに含まれるわけではありません。コミット直前にも状態と差分を確認する習慣を付けましょう。
4.プルリクエストで変更内容を共有する
GitHubでプルリクエストを作成するときは、統合先のブランチと変更元のブランチを確認します。この例では、baseをmain、compareをfeature/contact-formにします。
タイトルと説明には、「何を変えたか」に加えて、「なぜ変えたか」「何を確認したか」を記載します。まだ確認できていないことがあれば、完了した確認と区別して伝えてください。
たとえば、入力欄だけを作った段階なら、メール送信まで実装済みであるかのように説明しないことが大切です。レビューする人が、確認すべき範囲を判断できる内容にします。
承認や自動チェックは、品質を保証するものではない
レビューや自動テストを通過しても、すべての不具合がなくなるわけではありません。変更した機能の動作と、既存の機能への影響を確認してから統合します。
GitHubで選択できる統合方法には、マージコミット、Squash、Rebaseなどがあります。利用できる方法はリポジトリの設定にもよるため、チームの運用に合わせて選びましょう。
AIが生成した変更をプルリクエストへ含める場合も、仕様や動作の確認が必要です。レビューで見る項目と、テスト結果の扱い方を整理しています。
AI生成コードのレビュー方法|仕様・テスト・保守性を確認する実践手順 記事を読む →5.コンフリクトは、変更の統合を自動で決められない状態
コンフリクトは、Gitが複数の変更を自動で統合できないときに発生します。同じ行を異なる内容へ変更した場合だけでなく、一方で編集し、もう一方で削除した場合などにも発生します。
同時刻に編集している必要はなく、一人で別々のブランチを編集していても起こります。また、コンフリクトが発生しなかった場合でも、統合後のプログラムが正しく動くとは限りません。
作業用ブランチへmainの変更を取り込む例
以下は、作業用ブランチに最新のmainをマージする運用の例です。未コミットの変更を整理し、チームがこの方法を採用していることを確認したうえで実行します。
fetchはリモートの情報を取得し、origin/mainなどを更新します。その後のmergeで、取得したmainの変更を現在の作業用ブランチへ統合します。この操作だけでGitHub上のmainが更新されるわけではありません。
競合したファイルと、両方の変更意図を確認する
コンフリクトが起きたら、まずgit statusで対象のファイルを確認します。テキストの競合では、ファイルに次のような目印が入る場合があります。
このマージ例では、HEAD側が現在の作業用ブランチ、origin/main側が取り込もうとしている変更です。「上が常に自分、下が常に他人」と覚えるのではなく、実行した操作とブランチを確認してください。Rebaseなどでは、表示の解釈に注意が必要です。
解決するときは、単に片方を選ぶのではなく、最終的に必要な内容へ編集します。見出しだけでなく、フォームの目的やリンク先との整合性も確認しましょう。
修正・確認・記録の順に進める
競合の目印を取り除き、必要な内容へ修正したら、対象機能の動作やテスト結果を確認します。次に、解決したファイルをステージングして、マージを完了します。
ここではindex.htmlだけが競合した例を示しています。複数のファイルが競合している場合は、すべての解決を確認してからコミットしてください。
このコミット手順は、コンフリクトで止まったマージを解決する場合のものです。競合せずにマージが完了している場合や、Rebase中の場合に、そのまま当てはめないようにします。
解決せずにマージを中止したい場合
進行中のマージを中止する場合は、git merge –abortを使います。ただし、マージ開始前に未コミットの変更があると、元の状態を完全には復元できない場合があります。
そのため、マージ前に作業状態を整理することが重要です。すでに完了したマージを取り消す操作とも異なるため、まずgit statusで現在の状態を確認してください。
6.間違えたときは、コミット前後と共有状況を分けて考える
「mainで作業してしまった」といっても、まだファイルを編集しただけなのか、コミット済みなのか、GitHubへpush済みなのかで対応が変わります。最初に状態を確認し、同じ取り消しコマンドですべて解決しようとしないことが大切です。
| 状況 | 対応の考え方 |
|---|---|
| mainで編集したが、まだコミットしていない | 現在の位置から新しい作業用ブランチを作り、変更を確認してコミットする方法を検討する |
| mainにコミットしたが、まだpushしていない | 現在のコミットを指すブランチを作って履歴を保持し、mainをどう戻すかは履歴を確認して判断する |
| 共有ブランチへpush済み | 他の人の作業への影響を確認し、打ち消すコミットを作るrevertなどを検討する |
| pushを拒否された | リモート側の更新、権限、保護ルールなど、エラーの原因を確認する |
未コミットなら、新しいブランチを作る方法がある
通常のmain上で未コミットの編集を行っただけなら、その位置から新しいブランチを作り、変更を持ち越せます。マージなどの途中でないことを確認してから行います。
この操作でmainのコミット履歴を変更するわけではありません。ブランチ作成後に、必要なファイルをステージングしてコミットします。すでに同名のブランチがある場合は、別の名前を選んでください。
stashは、コミット済みの履歴を移す機能ではない
stashは、作業途中の未コミットの変更を一時退避するために使います。すでにmainへ作ったコミットを、stashで別ブランチへ移動することはできません。
また、通常のgit stashでは未追跡ファイルは対象にならず、復元時に競合する場合もあります。何が保存されたかを確認せず、すべての変更を退避できたと考えないようにしましょう。
共有済みの履歴を強制的に書き換える操作や、変更を破棄する操作は、状況を確認してから判断します。pushの拒否を解消するためだけにforce pushを使うことは避けてください。
7.コンフリクトを減らすための作業習慣
コンフリクトを完全になくすことはできませんが、変更の範囲を整理すると、発生時にも判断しやすくなります。大切なのは、競合の件数だけを減らすことではなく、変更の意図を追える状態にすることです。
- 1つのブランチで扱う目的を絞る:機能追加と、大規模な名前変更や整形を必要以上に混ぜない。
- 変更を小さく共有する:長期間ため込まず、途中の相談にはDraftのプルリクエストなども使う。
- 同じ場所の作業を共有する:共通ファイルや設定を大きく変える前に、担当者同士で調整する。
- 統合後に確認する:各ブランチで動いていても、組み合わせた状態で再確認する。
- 変更理由を残す:後から読んだ人が、採用した仕様と判断の背景を追えるようにする。
AIにコンフリクトの解決案を出してもらう場合も、両方の変更目的を伝えてください。競合の目印を消すだけの修正では、必要な機能まで失う可能性があります。
Git上で統合できたことと、仕様どおりに動くことを分けて確認しましょう。特に入力項目、データ形式、関数の呼び出し方を変えた場合は、関連する処理にも目を向けます。
統合後にエラーが出たときは、むやみに変更を重ねず、再現条件とログから原因を絞り込みましょう。調査の進め方と、ログを共有するときの注意点を紹介しています。
エラーログの読み方|原因を絞り込む調査手順と、安全な記録・共有の方法 記事を読む →8.ブランチ運用についてよくある質問
個人開発でもプルリクエストは必要ですか?
必須ではありませんが、変更内容と確認結果を振り返る場所として利用できます。自分でレビューする場合も、差分をまとめて見直すことで、不要な変更や確認漏れに気付くきっかけになります。
ブランチ名はfeature/で始めなければいけませんか?
必須ではありません。feature/contact-formやfix/header-layoutなど、目的がわかる名前を付け、チームでルールがある場合はそれに従います。名前だけで権限や公開先が自動的に決まるわけではありません。
GitHub上でコンフリクトを解決できますか?
単純な行の競合などは、GitHubの画面上で解決できる場合があります。一方、競合の種類によっては手元のリポジトリでの対応が必要です。動作確認が必要な変更では、修正後のコードを実行できる環境でも確認しましょう。
マージしたら、自動で公開されますか?
リポジトリと公開サービスの設定によって異なります。mainへの統合をきっかけに自動デプロイされる構成もあれば、別の操作が必要な構成もあります。マージ前に、公開までの流れを確認してください。
9.小さな変更で、記録から統合までを経験する
Git・GitHubの基本は、現在の状態を確認し、変更を選んで記録し、内容を確かめてから統合することです。コマンドが成功したかだけでなく、どのブランチに何が記録されたかを確認しましょう。
練習では、専用のリポジトリで見出しや説明文を1か所変更し、ブランチ作成、コミット、push、プルリクエストまで進めてみてください。次に競合を意図的に作り、両方の変更を確認して解決する練習へ進むと、操作と履歴の関係を理解しやすくなります。
参考資料
- GitHub Docs:GitHub flow — ブランチを使った共同作業の流れ。
- Git:git switch — ブランチの作成と切り替え。
- Git:git pull — リモートの変更取得と現在のブランチへの統合。
- Git:git merge — マージ、競合時の処理、中止に関する説明。
- GitHub Docs:Merge conflicts — コンフリクトの原因と解決方法。
- Git:git stash — 未コミットの変更の一時退避。
Learning Tools
記事を検索したい方はここから!
記事を検索
関連記事や、今の内容に近いテーマをすぐに検索できます。
例: AI / 情報Ⅰ / Python / 統計 / 資格 / 学習法