Gitでマージの競合(コンフリクト)を解決する方法
別のブランチを git merge で取り込もうとして、CONFLICT (content): Merge conflict in ... と表示されて止まったときは、競合(コンフリクト)したファイルを自分で書き直してから git add と git commit を実行すれば、マージを終えられます。マージ自体をやめたいときは、git merge --abort でマージ前の状態に戻せます。以下では、競合したファイルの読み方と、解決するまでの操作の前後の出力を、検証環境で実際に打ったとおりに載せます。
検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定し、出力が毎回同じになるよう、コミットの日時を環境変数で決めました。リポジトリは手元に作ったものだけで、リモートとのやり取り(git pull での競合)、git mergetool やエディターの競合解決の機能、Windows・macOS は試していません。
競合する2つのブランチ
index.html を持つリポジトリで、main と schedule の2つのブランチが、それぞれ別のコミットを積んでいる状態から始めます。
$ git log --graph --oneline --all
* 0f9bc80 土曜も更新する
| * e851e49 フッターの年を直す
| * f5bc99d 更新日を月曜にする
|/
* 16b5a97 最初のコミット
元の index.html の2行目は「毎週金曜に更新します」でした。main ではこの行を「毎週金曜と土曜に更新します」に変え、schedule では同じ行を「毎週月曜に更新します」に変えています。schedule では、それとは別に、最後の行のフッターの年も 2025 から 2026 に直しています。マージ前の main の index.html は次のとおりです。
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜と土曜に更新します</p>
<ul>
<li>記事の一覧</li>
</ul>
<footer>2025 ねこノート</footer>
git merge で CONFLICT と表示されたら
main にいる状態で schedule をマージすると、Git は自動でのマージをあきらめて止まります。
$ git merge schedule
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
$ git status
On branch main
You have unmerged paths.
(fix conflicts and run "git commit")
(use "git merge --abort" to abort the merge)
Unmerged paths:
(use "git add <file>..." to mark resolution)
both modified: index.html
no changes added to commit (use "git add" and/or "git commit -a")
git status の Unmerged paths に並んでいるのが、競合したファイルです。both modified は、両方のブランチが同じファイルを変更し、まだマージできていないという意味です。別の回に同じ競合を起こして、短い表示の git status --short で確かめると、次のように表示されました。
$ git status --short
UU index.html
git status の公式リファレンスでは、UU は「unmerged, both modified」と説明されています。表示のとおり、選べる道は2つです。競合を直して git commit するか、git merge --abort でマージをやめるかです。
競合したファイルの読み方
競合したファイルを開くと、ぶつかった部分が <<<<<<<、=======、>>>>>>> の3種類の行で区切られています。
$ cat index.html
<h1>ねこノート</h1>
<<<<<<< HEAD
<p>毎週金曜と土曜に更新します</p>
=======
<p>毎週月曜に更新します</p>
>>>>>>> schedule
<ul>
<li>記事の一覧</li>
</ul>
<footer>2026 ねこノート</footer>
<<<<<<< HEAD から ======= までが、いまいるブランチ(main)の内容です。======= から >>>>>>> schedule までが、取り込もうとしている schedule の内容です。最後の行のフッターは、schedule の側だけが変えた行なので、競合にはならず、すでに 2026 に直っています。git merge の公式リファレンスにある、競合の表示についての説明でも、片側だけが変えた部分はそのまま取り込まれ、両側が同じ部分を変えたときだけ、両方の内容を残して判断を求めると書かれています。

競合している間は、どちらの側の元のファイルも、インデックス(ステージ)に残っています。git show に :1:(2つのブランチが分かれる前)、:2:(いまのブランチ)、:3:(取り込む側)を付けると、それぞれのファイルを表示できます。
$ git show :1:index.html | sed -n 2p
<p>毎週金曜に更新します</p>
$ git show :2:index.html | sed -n 2p
<p>毎週金曜と土曜に更新します</p>
$ git show :3:index.html | sed -n 2p
<p>毎週月曜に更新します</p>
直さないままではコミットできない
競合したファイルを git add しないまま git commit を実行すると、エラーで止まります。
$ git commit --no-edit
error: Committing is not possible because you have unmerged files.
hint: Fix them up in the work tree, and then use 'git add/rm <file>'
hint: as appropriate to mark resolution and make a commit.
fatal: Exiting because of an unresolved conflict.
U index.html
区切りの行を消し忘れていないかは、git diff --check で確かめられます。区切りの行が残っていると、その行番号が表示されます。
$ git diff --check; echo "exit=$?"
index.html:2: leftover conflict marker
index.html:4: leftover conflict marker
index.html:6: leftover conflict marker
exit=2
ファイルを書き直し、add と commit で終える
どちらか片方を選ぶ必要はありません。ここでは両方の変更を生かして、「毎週月曜と土曜に更新します」にしました。区切りの3行を消し、2つの行を1行にまとめた index.html は次のとおりです(検証では printf でファイルを書き直しました)。
$ cat index.html
<h1>ねこノート</h1>
<p>毎週月曜と土曜に更新します</p>
<ul>
<li>記事の一覧</li>
</ul>
<footer>2026 ねこノート</footer>
$ git diff --check; echo "exit=$?"
exit=0
区切りの行が残っていなければ、git diff --check は何も表示しません。直したファイルを git add すると、git status の表示が変わります。
$ git add index.html
$ git status
On branch main
All conflicts fixed but you are still merging.
(use "git commit" to conclude merge)
Changes to be committed:
modified: index.html
$ git commit --no-edit
[main f267e44] Merge branch 'schedule'
$ git log --graph --oneline
* f267e44 Merge branch 'schedule'
|\
| * e851e49 フッターの年を直す
| * f5bc99d 更新日を月曜にする
* | 0f9bc80 土曜も更新する
|/
* 16b5a97 最初のコミット
--no-edit は、エディターを開かずに、Git が用意したメッセージ(Merge branch 'schedule')でコミットするためのオプションです。2つのブランチをつなぐマージコミットができ、競合は解決しました。git merge の公式リファレンスにある、競合の解決のしかたの説明によると、最後の git commit の代わりに git merge --continue を使ってもよく、こちらはマージの途中であることを確かめてから git commit を実行します。
マージをやめて、元の状態に戻す
競合の内容を見て、いまはマージしないと決めたときは、git merge --abort を実行します。検証のため、上のマージコミットを git reset --hard HEAD~1 で取り消してマージ前の状態に戻し、もう一度 git merge schedule で競合させてから試しました。
$ git merge schedule
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
$ git merge --abort
$ git status
On branch main
nothing to commit, working tree clean
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜と土曜に更新します</p>
<ul>
<li>記事の一覧</li>
</ul>
<footer>2025 ねこノート</footer>
$ git log --oneline -1
0f9bc80 土曜も更新する
index.html は、区切りの行も、自動で取り込まれていたフッターの 2026 もなくなり、マージ前の main の内容に戻りました。
git merge の公式リファレンスの –abort の説明によると、コミットしていない変更がある状態でマージを始めると、git merge --abort でもその変更を元どおりに戻せない場合があります。マージの前に、変更をコミットするか、git stash でよけておくよう勧められています。
片方のブランチの内容をまるごと使う
どちらか一方の内容だけを残せばよいときは、ファイルを手で直す代わりに、git checkout の --theirs(取り込む側)や --ours(いまのブランチ)でファイルを選べます。もう一度競合させて、--theirs を使いました。
$ git checkout --theirs index.html
Updated 1 path from the index
$ cat index.html
<h1>ねこノート</h1>
<p>毎週月曜に更新します</p>
<ul>
<li>記事の一覧</li>
</ul>
<footer>2026 ねこノート</footer>
$ git add index.html
$ git commit --no-edit
[main dab42ef] Merge branch 'schedule'
**選ばれるのは、競合した部分だけでなく、そのファイル全体です。**もう一度競合させて --ours を選ぶと、2行目は main の内容になりましたが、競合していなかったフッターも main の 2025 に戻りました。schedule で直したフッターの年は、このファイルからは消えます。
$ git checkout --ours index.html
Updated 1 path from the index
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜と土曜に更新します</p>
<ul>
<li>記事の一覧</li>
</ul>
<footer>2025 ねこノート</footer>
このときは、git merge --abort でマージをやめました。なお、git checkout の公式リファレンスには、git rebase や git pull --rebase の途中では、ours と theirs の指す側が入れ替わって見えることがあると書かれています。
分かれる前の内容も一緒に表示する
ふだんの表示では、2つのブランチが分かれる前に、その部分がどうなっていたかは分かりません。設定 merge.conflictStyle を diff3 にしてからマージすると、||||||| の行のあとに、分かれる前の内容も表示されます。
$ git config merge.conflictStyle diff3
$ git config --show-origin merge.conflictStyle
file:.git/config diff3
$ git merge schedule
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
$ cat index.html
<h1>ねこノート</h1>
<<<<<<< HEAD
<p>毎週金曜と土曜に更新します</p>
||||||| 16b5a97
<p>毎週金曜に更新します</p>
=======
<p>毎週月曜に更新します</p>
>>>>>>> schedule
<ul>
<li>記事の一覧</li>
</ul>
<footer>2026 ねこノート</footer>
元は「毎週金曜」だったことが分かるので、main は土曜を足し、schedule は金曜を月曜に変えた、と読み取れます。--global を付けずに設定したので、git config --show-origin で確かめると、設定はこのリポジトリの .git/config に書かれていました。merge.conflictStyle の説明によると、もう1つの値 zdiff3 は diff3 と似ていますが、競合した部分の始めと終わりで両側が同じになっている行を、区切りの外に出します。





