Как решить конфликт в merge?

Как решить конфликт в merge

Конфликт слияния (merge conflict) возникает, когда Git не может автоматически объединить изменения. Рассмотрю полный процесс решения.

1. Когда возникает конфликт

Конфликт происходит, когда:

• Две ветки изменили одну и ту же строку в файле
• Одна ветка удалила файл, а другая его изменила
• Обе ветки добавили одноимённый файл с разным содержимым

# Попытка merge
git merge feature-branch

# Результат с конфликтом
Auto-merging src/main.py
CONFLICT (content): Merge conflict in src/main.py
Automatic merge failed; fix conflicts and then commit the result.

2. Определение конфликтов

# Посмотреть все файлы с конфликтами
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 as resolved)
        both modified:   src/main.py

3. Структура конфликта в файле

Откроем конфликтный файл:

# src/main.py

def calculate_sum(a, b):
<<<<<<< HEAD
    return a + b + 1  # Текущая ветка (main)
=======
    return a + b      # Входящая ветка (feature-branch)
>>>>>>> feature-branch

# Маркеры конфликта:
# <<<<<<< HEAD           - начало текущей ветки
# =======               - разделитель
# >>>>>>> branch-name   - конец входящей ветки

4. Способы разрешения

Способ 1: Выбрать текущую ветку (HEAD)

# Удаляем маркеры и код из входящей ветки
def calculate_sum(a, b):
    return a + b + 1  # Текущая ветка (main)

# Или через команду
git checkout --ours src/main.py

Способ 2: Выбрать входящую ветку

# Удаляем маркеры и код из текущей ветки
def calculate_sum(a, b):
    return a + b  # Входящая ветка

# Или через команду
git checkout --theirs src/main.py

Способ 3: Объединить оба решения

# Комбинируем оба подхода
def calculate_sum(a, b):
    result = a + b
    return result + 1  # Добавили логику от обеих веток

5. Пошаговый процесс разрешения

Шаг 1: Посмотреть конфликты подробно

# Показать разницу в конфликтах
git diff

# Показать конфликты только в одном файле
git diff src/main.py

# Показать what's incoming
git show :3:src/main.py  # Входящая версия

# Показать what's current
git show :2:src/main.py  # Текущая версия

Шаг 2: Редактировать и разрешить конфликт

# Откроем редактор
vim src/main.py

# Мануально удаляем маркеры конфликта:
# <<<<<<< HEAD
# =======
# >>>>>>> feature-branch

Код после разрешения:

def calculate_sum(a, b):
    return a + b + 1  # Если выбрали текущую

Шаг 3: Добавить файл в staging

# Добавить отдельный файл
git add src/main.py

# Или все разрешённые файлы
git add .

Шаг 4: Завершить merge

# Создать merge commit
git commit -m "Resolve merge conflict in calculate_sum"

# Git использует дефолтное сообщение:
# Merge branch 'feature-branch' into main

6. Инструменты для разрешения конфликтов

Встроенный Git mergetool

# Запустить интерактивный merge tool
git mergetool

# Выбрать конкретный инструмент
git config merge.tool vimdiff
git mergetool

VS Code встроенный mergetool

# VS Code автоматически показывает конфликты
# с кнопками: Accept Current Change, Accept Incoming, Accept Both

# Или в CLI:
git config merge.tool code
git config mergetool.code.cmd 'code --wait $MERGED'

Визуальные инструменты

# P4Merge
git config merge.tool p4merge
git config mergetool.p4merge.cmd 'p4merge "$BASE" "$LOCAL" "$REMOTE" "$MERGED"'

# Meld
git config merge.tool meld

7. Проверка разрешения

# Посмотреть статус
git status

# Должно быть:
# On branch main
# All conflicts fixed but you are still merging.
#   (use "git commit" to conclude merge)

# Проверить, что маркеры удалены
grep -r "<<<<<<< HEAD" src/
# Не должно быть вывода

8. Отмена merge если что-то пошло не так

# Отменить merge ДО commit
git merge --abort

# Отменить merge ПОСЛЕ commit
git reset --hard HEAD~1

# Или через revert
git revert -m 1 <merge-commit-hash>

9. Сложные конфликты

Конфликт с удалённым файлом

# Git show показывает ошибку если файл удалён
# Решение: либо удалить, либо восстановить

git rm filename.txt      # Согласиться с удалением
git checkout --ours filename.txt  # Восстановить

Конфликт в бинарном файле

# Бинарные файлы нельзя редактировать вручную
# Выбрать одну версию полностью

git checkout --ours image.png    # Текущая версия
git checkout --theirs image.png  # Входящая версия
git add image.png

Конфликт при rebase

# При rebase тоже могут быть конфликты
git rebase feature-branch

# Разрешить как при merge, потом
git add .
git rebase --continue

# Или отменить
git rebase --abort

10. Лучшие практики

Избегать конфликтов

# Часто синхронизировать с main
git fetch origin
git rebase origin/main

# Работать в узких ветках (разные файлы/функции)
# Не делать большие merge с множеством изменений

Когда слишком много конфликтов

# Отменить и переделать
git merge --abort

# Переделать ветку из свежего main
git checkout feature-branch
git reset --hard origin/main
git cherry-pick <commits>  # Или вручную переаплаить

Использовать merge strategies

# Recursive (default)
git merge -X ours feature-branch   # Предпочитаем текущую
git merge -X theirs feature-branch # Предпочитаем входящую

# Resolve (старый, лучше для простых случаев)
git merge -s resolve feature-branch

# Octopus (для нескольких веток)
git merge feature1 feature2 feature3

11. Сценарии из реальной жизни

Сценарий 1: Два разработчика изменили одну функцию

# Разработчик A (текущая ветка)
def process(data):
    return data.upper()

# Разработчик B (входящая ветка)
def process(data):
    return data.lower()

# Решение: спросить что нужно или объединить
def process(data):
    return data.strip().upper()  # Объединённое решение

Сценарий 2: Переименование и изменение

# Git может заметить переименование
git merge --no-ff feature-branch

# Или настроить threshold для детекции переименования
git config diff.renameLimit 99999
git merge feature-branch

Команды быстрой справки

# Общий процесс
git status                         # Посмотреть конфликты
vim src/main.py                    # Отредактировать
git add src/main.py                # Пометить как разрешено
git commit -m "Resolved conflicts" # Завершить merge

# Быстрые решения
git checkout --ours src/main.py    # Выбрать текущую ветку
git checkout --theirs src/main.py  # Выбрать входящую ветку

# Отмена
git merge --abort                  # Отменить merge
git reset --hard HEAD~1            # Откатить последний commit

Вывод

Разрешение конфликтов — обычная часть работы с Git. Главное:

1. Понимать структуру конфликта
2. Выбирать подходящее решение (текущая/входящая/объединить)
3. Тестировать после разрешения
4. Избегать конфликтов через частую синхронизацию

Практика делает совершенным!