Git初心者必見！マージコンフリクトの解決方法を完全ガイド
Tech Trends AI
- 2 minutes read - 259 wordsGit初心者必見！マージコンフリクトの解決方法を完全ガイド
Gitを使っていると必ず遭遇するのが「マージコンフリクト」です。初心者の方にとっては一見複雑に見えるかもしれませんが、実は基本的なパターンを理解すれば簡単に解決できます。
マージコンフリクトとは？
マージコンフリクト（Merge Conflict）とは、複数の人が同じファイルの同じ箇所を異なる内容で編集した際に、Gitが自動的にマージできない状況のことです。
よくある発生パターン
- 複数人で同じファイルを編集
- 自分のブランチと main ブランチで同じ行を変更
- ファイルの削除と編集が同時に発生
コンフリクトが発生したときの状況を理解する
コンフリクトが発生すると、以下のようなメッセージが表示されます：
$ git merge feature-branch
Auto-merging index.html
CONFLICT (content): Merge conflict in index.html
Automatic merge failed; fix conflicts and then commit the result.
この時点で、Gitは作業を中断し、ユーザーに解決を求めています。
実際のコンフリクト解決手順
ステップ1: コンフリクトファイルの確認
git status
コンフリクトが発生しているファイルは「both modified」として表示されます。
ステップ2: コンフリクト箇所の確認
コンフリクトが発生したファイルを開くと、以下のような表示になっています：
<!DOCTYPE html>
<html>
<head>
<title>マイサイト</title>
</head>
<body>
<<<<<<< HEAD
<h1>ようこそ、私のウェブサイトへ！</h1>
<p>最新情報をお届けします。</p>
=======
<h1>Welcome to My Website!</h1>
<p>最新のニュースをチェックしてください。</p>
>>>>>>> feature-branch
</body>
</html>
マーカーの意味
<<<<<<< HEAD: 現在のブランチ（通常はmain）の内容の開始=======: 区切り線>>>>>>> feature-branch: マージしようとしているブランチの内容の終了
ステップ3: 解決方法を決定する
3つの選択肢があります：
- 現在のブランチの内容を採用
- マージするブランチの内容を採用
- 両方の内容を組み合わせて新しい内容を作成
ステップ4: 実際の編集
例えば、両方の良い部分を組み合わせる場合：
<!DOCTYPE html>
<html>
<head>
<title>マイサイト</title>
</head>
<body>
<h1>ようこそ、私のウェブサイトへ！</h1>
<p>最新のニュースと情報をお届けします。</p>
</body>
</html>
重要: コンフリクトマーカー（<<<<<<<, =======, >>>>>>>）は必ず削除してください。
ステップ5: 変更をステージング
git add index.html
ステップ6: コミットして完了
git commit -m "Resolve merge conflict in index.html"
コンフリクト解決のベストプラクティス
1. 冷静に状況を把握する
コンフリクトは「エラー」ではなく、「確認が必要な状況」です。慌てずに以下を確認：
- どのファイルでコンフリクトが発生したか
- どのような変更が競合しているか
- どちらの変更が適切か
2. チームメンバーとのコミュニケーション
同じファイルを編集した相手がいる場合は、以下を確認：
- どちらの変更を採用すべきか
- 両方の変更を組み合わせる必要があるか
- 仕様や要件に照らして正しい内容は何か
3. テストを忘れずに
コンフリクト解決後は必ずテストを実行：
# 例：Node.jsプロジェクトの場合
npm test
# 例：アプリケーションの動作確認
npm start
よくあるトラブルと対処法
1. コンフリクトマーカーを削除し忘れた
症状: アプリケーションに <<<<<<< などの文字が表示される
対処法:
# コンフリクトマーカーを検索
grep -r "<<<<<<< HEAD" .
grep -r "=======" .
grep -r ">>>>>>>" .
2. 間違った解決をしてしまった
対処法:
# 直前のコミットを取り消す（コミット済みの場合）
git reset --hard HEAD~1
# マージ自体を取り消す（マージ中の場合）
git merge --abort
3. 大量のコンフリクトが発生した
対処法:
- 一度に全て解決しようとせず、ファイル単位で順番に処理
- 必要に応じてマージを中止し、ブランチを整理してから再実行
コンフリクトを減らすための予防策
1. 頻繁にプル・マージする
# 作業前に最新の状態に更新
git pull origin main
# 定期的に main ブランチの変更を取り込む
git merge main
2. 小さな単位でコミット
- 大きな変更は複数のコミットに分割
- 関連する変更をまとめてコミット
- 意味のあるコミットメッセージを書く
3. ブランチ戦略の活用
# 機能ごとにブランチを作成
git checkout -b feature/user-login
# 短期間で作業を完了し、早めにマージ
便利なツールの紹介
1. Visual Studio Code
VS Codeにはコンフリクト解決のための便利な機能が内蔵されています：
- コンフリクト箇所のハイライト表示
- ワンクリックで片方の変更を採用
- サイドバイサイドでの比較表示
2. GitKraken、SourceTree
GUI でのコンフリクト解決がより直感的に行えます。
3. コマンドラインツール
# より詳細なコンフリクト情報を表示
git diff
# マージ用の3-way diffツールを使用
git mergetool
まとめ
マージコンフリクトは最初は怖く感じるかもしれませんが、以下のポイントを抑えれば必ず解決できます：
- 落ち着いて状況を把握する
- コンフリクトマーカーの意味を理解する
- 適切な解決方法を選択する
- マーカーを完全に削除する
- 解決後にテストを行う
コンフリクトは開発チームでの協力の証でもあります。適切に解決することで、より良いコードベースを維持できるようになります。
最初のうちは時間がかかるかもしれませんが、慣れてくると数分で解決できるようになります。ぜひ実際のプロジェクトで練習してみてください！
参考リンク
この記事がGitのコンフリクト解決の助けになれば幸いです。質問やフィードバックがあればお気軽にコメントください！
PR
PR
