コンフリクトを解消しよう | Git レッスン6

🎯 このレッスンで学ぶこと

• コンフリクトが発生する条件を説明できます。
• コンフリクトマーカー（<<<, ===, >>>）を読めます。
• コンフリクトを手動で解消してコミットできます。
• コンフリクトを予防するコツを知っています。

📖 復習 — ブランチとマージのおさらい

• ブランチ名は feature/ fix/ などのプレフィックスをつける
• git switch -c ブランチ名 で作成+切り替え
• git merge ブランチ名 で変更を統合
• マージ後はブランチを削除する

💥 1. コンフリクトとは？

コンフリクト（競合）とは、2つのブランチで同じファイルの同じ行を別々に変更したとき、Git がどちらを採用すべきかわからなくなる状態です。

📓 たとえ話: 2人が同じノートの同じ行に別のことを書いた。ノートを1冊にまとめるとき、どっちを残す？ → 2人で話し合って決める必要がある。これがコンフリクト解消です。

自動マージできるケース vs できないケース:

• ✅ 自動マージ: 別のファイルを変更 / 同じファイルでも別の行を変更
• ❌ コンフリクト: 同じファイルの同じ行を両方で変更

🔍 2. コンフリクトを体験してみよう

意図的にコンフリクトを起こして、解消の練習をしましょう。

1. main で変更してコミット:

   git switch main
   echo "こんにちは" > greeting.txt
   git add greeting.txt
   git commit -m "挨拶ファイルを追加"

💡 ブランチを作ると、その時点の main の内容がコピーされます。
つまり feature ブランチを作った時点では greeting.txt の中身は「こんにちは」です。ここから別の内容に変えることでコンフリクトが起きます。
2. feature ブランチで同じ行を別の内容に変更:

   git switch -c feature/change-greeting
   echo "Hello" > greeting.txt
   git add greeting.txt
   git commit -m "挨拶を英語に変更"

3. main に戻ってマージ → コンフリクト発生！

   git switch main
   git merge feature/change-greeting

   以下のようなメッセージが表示されます:

   CONFLICT (content): Merge conflict in greeting.txt
   Automatic merge failed; fix conflicts and then commit the result.

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

コンフリクトが起きたファイルを開くと、以下のようなマーカーが挿入されています:

<<<<<<< HEAD
こんにちは
=======
Hello
>>>>>>> feature/change-greeting

• <<<<<<< HEAD — ここから「今いるブランチ（main）」の内容
• ======= — 区切り線（ここで2つの変更が分かれる）
• >>>>>>> feature/change-greeting — ここまでが「マージ元ブランチ」の内容

解消の before / after:

Before（マーカーあり）:

<<<<<<< HEAD
こんにちは
=======
Hello
>>>>>>> feature/change-greeting

After（両方を組み合わせた例）:

こんにちは / Hello

マーカーを全て消して、最終的に残したい内容だけにします。

🔧 4. コンフリクトの解消手順

4ステップで解消します:

1. ファイルを開いてマーカーを確認する

   git status でどのファイルにコンフリクトがあるか確認できます:

   $ git status
   On branch main
   You have unmerged paths.
   
   Unmerged paths:
     (use "git add <file>..." to mark resolution)
           both modified:   greeting.txt

2. どちらの内容を残すか決める（または両方を組み合わせる）

   # 例: 両方を組み合わせる場合
   こんにちは / Hello

3. マーカー（<<<, ===, >>>）を全て削除する
4. git add → git commit で解消を記録する

   git add greeting.txt
   git commit

   （コミットメッセージは自動で「Merge branch ...」が入ります）

🛡️ 5. コンフリクトを予防するコツ

• こまめに git pull して最新を取り込む — main の変更を早めに取り込むことで、大きなコンフリクトを防げる

  # feature ブランチで作業中に main の最新を取り込む
  git switch main
  git pull origin main
  git switch feature/my-work
  git merge main

• 1つのブランチで長期間作業しない — 長く作業するほど main との差が広がり、コンフリクトが起きやすくなる
• チームで「誰がどのファイルを触るか」を共有する — 同じファイルを同時に編集しないよう調整する
• 小さい単位でコミット・マージする — 大きな変更を一気にマージするとコンフリクトが複雑になる

💻 やってみよう！

以下の手順でコンフリクトの発生から解消までを体験しましょう。

1. main ブランチで greeting.txt を作成してコミット

   git switch main
   echo "こんにちは" > greeting.txt
   git add greeting.txt
   git commit -m "挨拶ファイルを追加"

2. feature ブランチを作り、同じファイルを別の内容に変更

   git switch -c feature/change-greeting
   echo "Hello" > greeting.txt
   git add greeting.txt
   git commit -m "挨拶を英語に変更"

3. main に戻ってマージ → コンフリクト発生

   git switch main
   git merge feature/change-greeting

4. greeting.txt を開いてマーカーを確認する
5. 好きな内容に書き換えて、マーカーを全て削除する
6. 解消を記録する

   git add greeting.txt
   git commit

7. git log --oneline でマージコミットが記録されていることを確認

コンフリクトを解消できたら、このレッスンは完了です！ 🎉

⚠️ よくあるミス

• マーカーを消し忘れてコミット — <<<<<<< や ======= がファイルに残ったままだとコードが壊れます。保存前にファイル内を検索して確認しましょう。
• コンフリクト中に別の作業を始める — 解消が完了するまで他のファイルを触らないこと。git status で「Unmerged paths」が消えるまで集中しましょう。
• コンフリクトを放置する — 時間が経つほど状況を忘れて解消が難しくなります。発生したらすぐに対処しましょう。