$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

コンフリクト

コンフリクトとは

2 つのブランチが、同じファイルの同じ場所を別々に変更していた ときに起きます。Git は「どちらが正しいか」を判断できないので、マージを途中で止めて人間に決めてもらいます。

これは Git が壊れたのでも、あなたがミスをしたのでもありません。並行して作業すれば必ず起きる、普通の出来事 です。

起きないケース、起きるケース

Git は思っているより賢く、多くの場合は自動でマージしてくれます。

状況結果
別々のファイルを変更自動マージ
同じファイルの 別々の行 を変更自動マージ
同じファイルの 同じ行(または隣接する行) を変更コンフリクト
片方が変更、もう片方が削除コンフリクト

何が起きるか

$ git merge feature/title
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Automatic merge failed; fix conflicts and then commit the result.

このとき Git は次の状態になっています。

  • マージは 途中で止まっている(Git の状態をプロンプトに出す設定をしていれば |MERGING と出る。このシミュレーターでも表示されます)
  • 衝突したファイルに コンフリクトマーカー が書き込まれている
  • 衝突しなかった部分はすでにマージ済み

git status を打つと Unmerged paths に衝突したファイルが並びます。

コンフリクトマーカーの読み方

<<<<<<< HEAD
# レシピ帳
=======
# Recipe App 🍳
>>>>>>> feature/title
レシピを管理する小さなアプリです。
部分意味
<<<<<<< HEAD 〜 =======自分側(いまいるブランチ、HEAD)の内容
======= 〜 >>>>>>> feature/title相手側(マージしようとしたブランチ)の内容
マーカーの外衝突していない部分。そのまま

解消の手順

  1. 落ち着く。git status で衝突したファイルを確認
  2. ファイルを開き、最終的にあるべき内容 に書き換える
    • 自分側を採用 / 相手側を採用 / 両方を組み合わせる / まったく別の内容にする、どれでもよい
    • マーカーの 3 行(<<<<<<< ======= >>>>>>>)は必ず消す
  3. git add <ファイル> で「解決した」と Git に伝える
  4. 全ファイル解決したら git commit(マージのときは Merge branch ... というメッセージが用意されるので -m は不要。本物の Git ではエディタが開くので、そのまま保存して閉じる)
git status                  # どれが衝突しているか
vim README.md               # 直す
git add README.md           # 解決を伝える
git commit                  # マージ完了

やめたいとき

途中でやめて、マージ前の状態に戻すことができます。

git merge --abort

rebase 中なら git rebase --abort、cherry-pick / revert 中なら git cherry-pick --abort / git revert --abort です。

いつでも逃げられる と知っていれば、コンフリクトは怖くありません。

よくある失敗

  • マーカーを消し忘れる — <<<<<<< が残ったままコミットしてしまう。プログラムなら構文エラーになります。コミット前に git diff --staged で確認
  • 相手の変更を消してしまう — 自分側だけ残してしまい、相手の作業が消える。相手側が何を変えたのか、マージ前に git diff main...feature(ドット 3 つ。分岐してから feature で変わった部分だけを表示)で見ておく
  • どっちが HEAD か分からなくなる — HEAD はいまいるブランチ。git merge feature を main で実行したなら、HEAD = main

コンフリクトを減らすには

  • こまめに pull / merge する — 分岐が長いほど衝突しやすい。main の変更は早めに自分のブランチに取り込む
  • 小さいブランチ、小さい PR — 変更が少なければ衝突も少ない
  • 同じファイルを同時に触らない — 担当を分ける、事前に声をかける
  • フォーマッタの設定を揃える — インデントや改行コードの違いが、意味のない衝突を生む

手を動かして確かめる

このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。