コンフリクト
コンフリクトとは
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 | 相手側(マージしようとしたブランチ)の内容 |
| マーカーの外 | 衝突していない部分。そのまま |
解消の手順
- 落ち着く。
git statusで衝突したファイルを確認 - ファイルを開き、最終的にあるべき内容 に書き換える
- 自分側を採用 / 相手側を採用 / 両方を組み合わせる / まったく別の内容にする、どれでもよい
- マーカーの 3 行(
<<<<<<<=======>>>>>>>)は必ず消す
git add <ファイル>で「解決した」と Git に伝える- 全ファイル解決したら
git commit(マージのときはMerge branch ...というメッセージが用意されるので-mは不要。本物の Git ではエディタが開くので、そのまま保存して閉じる)
git status # どれが衝突しているか
vim README.md # 直す
git add README.md # 解決を伝える
git commit # マージ完了やめたいとき
途中でやめて、マージ前の状態に戻すことができます。
git merge --abortrebase 中なら 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 — 変更が少なければ衝突も少ない
- 同じファイルを同時に触らない — 担当を分ける、事前に声をかける
- フォーマッタの設定を揃える — インデントや改行コードの違いが、意味のない衝突を生む
手を動かして確かめる
このトピックは レッスンで実際に試せます。自由に試したい場合は プレイグラウンドへ。