LASSIC Media らしくメディア
Gitでコンフリクトが起きる理由と解消手順|減らす運用のコツ
監修・編集責任者:牛尾 昭昌(株式会社LASSIC 執行役員)
この記事の結論
- gitのコンフリクトは、2つのブランチが同じ箇所を別々に変え、Gitが片方を選べないときに起きます。
- 解消は、区切りの記号を読んで残す内容を決め、書き直して解消済みとして登録し、記録する流れです。
- ブランチを長く分けたままにしないことと、区切りの記号の消し忘れを自動で見張ることが減らす近道です。
※ 本記事は2026年10月時点の公式情報(省庁・公的機関、および製品やサービスを提供する事業者が公開している資料)に基づきます。
gitのコンフリクト(競合)は、複数人でプログラムを直していると避けて通れない現象です。ブランチ(作業の枝分かれ)を取り込もうとしたら「CONFLICT」と表示されて止まった、ファイルに見慣れない記号が書き込まれた、プルリクエストのマージボタンが押せない。そんな場面でこの言葉を調べる方が多いでしょう。
本記事では、Gitの公式ドキュメントとGitHub Docsをもとに、gitのコンフリクトが起きる理由、解消の進め方、つまずきやすい点と減らす運用を、初心者向けに図と表で整理します。開発を外部に委託するときに確認しておきたい点も紹介します。
目次
gitのコンフリクトとは
gitのコンフリクトは、2つのブランチの変更をGitが自動でまとめられず、人の判断を待って止まった状態です。故障ではなく、Gitが片方を勝手に選ばず、判断を人に返している状態だと考えると分かりやすくなります。
- 同じ行への別々の変更:同じファイルの同じ行を、2人が違う内容に変えた*1
- 編集と削除のぶつかり:一方がファイルを編集し、もう一方が同じファイルを削除した*1
- 起きない場合:変更が別の行や別のファイルにあれば、Gitが自動でまとめる
GitHubでは、プルリクエスト(変更の取り込み依頼)にコンフリクトがある間はマージのボタンが押せず、解消するまで取り込めません。*1
コンフリクトが起きる仕組み
Gitは、2つのブランチの最新の状態と、両者が分かれる前の共通の祖先の3つを比べて変更をまとめます。これを3方向マージと呼びます。
- 片方だけが変えた箇所:変えた側の内容がそのまま取り込まれる
- 両方が同じ内容に変えた箇所:問題なく1つにまとまる
- 両方が違う内容に変えた箇所:Gitはどちらも選ばず、コンフリクトとして残す
図の例では、設定ファイルの待ち時間を、共通の祖先の30から、mainブランチは60に、featureブランチは45に変えました。コンフリクトが起きると、Gitは衝突したファイルについて、祖先・自分の側・相手の側の版を3つまで記録しておきます。*2 どちらの値を残すかは、この3つを見比べて人が決めます。
コンフリクトの解消の進め方
コンフリクトしたファイルには、「<<<<<<<」「=======」「>>>>>>>」という区切りの記号が書き込まれます。記号の前半がふつう自分の側、後半が相手の側の内容です。*2 解消は次の流れで進めます。
- ステップ1 確かめる:どのファイルがコンフリクトしているかを、Gitの状態表示で確かめる
- ステップ2 決める:自分の側、相手の側、両方を合わせた新しい内容のどれを残すかを決める
- ステップ3 書き直す:区切りの記号を消し、最終的な内容に書き直す
- ステップ4 登録する:解消済みとして登録し、マージを記録して完了する*2
既定の表示では、衝突した箇所がもともと何だったかは出ません。*2 設定を変えると、元の内容もあわせて表示できます。*3 元の値が分かると、「どちらが何を変えたのか」を判断しやすくなります。
| 場面 | 解消の仕方 |
|---|---|
| 同じ行への別々の変更 | 区切りの記号を消して残す内容に書き直し、解消済みとして登録する |
| 一方が編集、もう一方が削除 | 区切りの記号は付かない。ファイルを残すか消すかを決めて登録する*4 |
| GitHub上の単純な競合 | GitHubの画面で解消できる*1 |
| GitHub上の複雑な競合 | 手元のリポジトリで解消し、プルリクエストのブランチへ送り直す*1 |
マージをやめたいときは、取りやめる操作でマージ前の状態に戻せます。ただし、マージを始める前に記録していない変更があると、元に戻せないことがあります。*2 マージの前には、作業中の変更を記録するか退避しておきます。
つまずきやすい点と減らす運用
解消の作業でつまずきやすいのは、次の3点です。
- 自分と相手が入れ替わる:マージではなくリベース(自分の変更を相手の最新の上に積み直す取り込み方)では、「自分の側」と「相手の側」が入れ替わる*5。逆の意味で選ぶと自分の変更を捨ててしまう
- 区切りの記号の消し忘れ:記号が残ったままでも解消済みとして登録できてしまう。Gitには記号の混入を警告する確認の機能がある*6
- 改行コードの違い:人によって改行の設定が違うと、1行の変更がファイル全体の差分になり、広い範囲で衝突する
コンフリクトの回数と規模は、運用で小さくできます。基本は、ブランチを長く分けたままにしないことです。考え方は「トランクベース開発へブランチ戦略を移行する外注」で扱っています。
- こまめに取り込む:作業の枝を短く保ち、main(本流のブランチ)へ早めに戻す
- 整形の設定をそろえる:見た目を整えるツールの設定を全員でそろえ、整形だけの差分を出さない
- 大きな変更を分ける:ファイルの移動や大きな書き換えを、機能の変更と別の記録に分ける
- 同じ解消を記録させる:Gitには、手で解いた結果を記録し、同じ衝突に再び出会ったときに当てはめる機能もある*7
外部に委託するときに確認しておきたい点
開発や保守を外部に頼むと、社内と委託先が同じリポジトリへ並行して変更を加える場面が増えます。どちらの変更を残すかはツールでは決まらないため、次の点を先に確かめておきます。
- 取り込みの頻度:ブランチを分けておく期間や、mainへ取り込む頻度が決められているか
- 判断する人:コンフリクトが起きたとき、どちらの変更を優先するかを誰が決めるか
- 結果の確認:解消した結果を、元の変更を書いた人やレビューの担当者が確かめる手順があるか
- 自動の見張り:区切りの記号の混入を、変更のたびに自動で検出しているか
- 設定の統一:改行コードや整形ツールの設定をチームでそろえているか
解消の判断を1人に任せきりにすると、相手の意図を知らないまま片方の変更を消してしまう事故が起きやすくなります。古いバージョン管理からGitへ移る途中なら「SourceSafeからGit移行」、Gitの基盤を自前で持つなら「GitLab/Gitea セルフホストGit基盤の外注構築」も参考になります。
まとめ:gitのコンフリクトで確かめたい3点
gitのコンフリクトで確かめておきたい点は3つです。第一に、コンフリクトは同じ箇所への別々の変更を人に判断させる仕組みで、Gitは祖先・自分の側・相手の側の3つの版を記録していること。第二に、区切りの記号を読んで残す内容を決め、書き直して解消済みとして登録し、マージを記録して完了させること。第三に、リベースでの自分と相手の入れ替わり、記号の消し忘れ、長く分かれたままのブランチに気をつけることです。
よくある質問
解消の途中で、やり直すことはできますか
マージを記録する前なら、取りやめる操作でマージ前の状態に戻せます。ただし、マージを始める前に記録していない変更があると戻せないことがあるため、マージの前に作業中の変更を記録するか退避しておきます。
自分の側と相手の側は、どう見分けますか
マージでは、区切りの記号の前半が今いるブランチ、後半が取り込むブランチの内容です。リベースでは入れ替わり、取り込む先のブランチが「自分の側」として示されます。
GitHubの画面でコンフリクトを解消できますか
GitHub Docsによると、同じ行の競合のような単純なものは、GitHubの画面で解消できます。複雑なものは手元のリポジトリで解消し、プルリクエストのブランチへ送り直します。
Gitの運用とコンフリクト対策のご相談
元請(プライムベンダー)として、リポジトリの運用ルールの整備からシステムの保守・運用までご提案します。
2006年の創業以来、一次請けのシステムインテグレーターとして、企業のシステム開発と保守・運用を受託してきました。
出典
- *1 参考:GitHub Docs「Merge conflicts」(https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/about-merge-conflicts)。出典:コンフリクトが起きやすい2つの場合、コンフリクトがある間はプルリクエストのマージボタンが無効になること、単純な競合はGitHub上で・複雑なものはローカルで解消することを参照(2026年10月確認)
- *2 参考:Git「git-merge Documentation」(https://git-scm.com/docs/git-merge)。出典:HOW CONFLICTS ARE PRESENTED(区切りの記号の意味、既定の形式では元の内容が表示されないこと)、衝突時のステージ1〜3、–abort の注意、HOW TO RESOLVE CONFLICTS を参照(2026年10月確認)
- *3 参考:Git「git-config Documentation」(https://git-scm.com/docs/git-config)。出典:merge.conflictStyle(diff3・zdiff3 で元の内容を表示する形式)を参照(2026年10月確認)
- *4 参考:GitHub Docs「Resolving a merge conflict using the command line」(https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts/resolving-a-merge-conflict-using-the-command-line)。出典:削除されたファイルの競合を、残すか消すかで解消する手順を参照(2026年10月確認)
- *5 参考:Git「git-rebase Documentation」(https://git-scm.com/docs/git-rebase)。出典:rebase では ours と theirs の両側が入れ替わることを参照(2026年10月確認)
- *6 参考:Git「git-diff Documentation」(https://git-scm.com/docs/git-diff)。出典:–check(コンフリクトマーカーと空白の誤りを警告する)を参照(2026年10月確認)
- *7 参考:Git「git-rerere Documentation」(https://git-scm.com/docs/git-rerere)。出典:手での解消結果を記録し、再び同じ衝突に当てはめることを参照(2026年10月確認)