Gitでマージの競合(コンフリクト)を解決する方法

​​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つのブランチが、それぞれ別のコミットを積んでいる状態から始めます。

console
$ git log --graph --oneline --all
* 0f9bc80 土曜も更新する
| * e851e49 フッターの年を直す
| * f5bc99d 更新日を月曜にする
|/  
* 16b5a97 最初のコミット

元の index.html の2行目は「毎週金曜に更新します」でした。main ではこの行を「毎週金曜と土曜に更新します」に変え、schedule では同じ行を「毎週月曜に更新します」に変えています。schedule では、それとは別に、最後の行のフッターの年も 2025 から 2026 に直しています。マージ前の main の index.html は次のとおりです。

console
$ cat index.html
<h1>ねこノート</h1>
<p>毎週金曜と土曜に更新します</p>
<ul>
  <li>記事の一覧</li>
</ul>
<footer>2025 ねこノート</footer>

git merge で CONFLICT と表示されたら

main にいる状態で schedule をマージすると、Git は自動でのマージをあきらめて止まります。

console
$ 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 で確かめると、次のように表示されました。

console
$ git status --short
UU index.html

git status の公式リファレンスでは、UU は「unmerged, both modified」と説明されています。表示のとおり、選べる道は2つです。競合を直して git commit するか、git merge --abort でマージをやめるかです。

競合したファイルの読み方

競合したファイルを開くと、ぶつかった部分が <<<<<<<、=======、>>>>>>> の3種類の行で区切られています。

console
$ 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 の公式リファレンスにある、競合の表示についての説明でも、片側だけが変えた部分はそのまま取り込まれ、両側が同じ部分を変えたときだけ、両方の内容を残して判断を求めると書かれています。

競合した index.html。<<<<<<< HEAD から ======= までが main の内容、======= から >>>>>>> schedule までが schedule の内容。フッターの行は競合せずにマージ済み。区切りの3行を消して残したい内容に書き換え、git add と git commit で終える
競合したファイルの区切りの意味と、解決のしかた

競合している間は、どちらの側の元のファイルも、インデックス(ステージ)に残っています。git show に :1:(2つのブランチが分かれる前)、:2:(いまのブランチ)、:3:(取り込む側)を付けると、それぞれのファイルを表示できます。

console
$ 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 を実行すると、エラーで止まります。

console
$ 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 で確かめられます。区切りの行が残っていると、その行番号が表示されます。

console
$ 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 でファイルを書き直しました)。

console
$ 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 の表示が変わります。

console
$ 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 で競合させてから試しました。

console
$ 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 を使いました。

console
$ 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 で直したフッターの年は、このファイルからは消えます。

console
$ 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 にしてからマージすると、||||||| の行のあとに、分かれる前の内容も表示されます。

console
$ 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 と似ていますが、競合した部分の始めと終わりで両側が同じになっている行を、区切りの外に出します。

​Posted by 86