Конфликты слияния

Откуда берётся конфликт

Конфликт слияния в Git (merge conflict) — это ситуация, когда две ветки изменили одну и ту же строку, и Git не может сам решить, какая версия правильная: он останавливает слияние и просит выбрать вас. Вы нарочно устроите конфликт на визитке, построчно разберёте маркеры <<<<<<<, ======= и >>>>>>> и решите конфликт в терминале и в VS Code.

Когда вы сливали подвал, Git сам соединил правки двух веток: они были в разных местах. Теперь посмотрим, что будет, если места совпадут.

Простыми словами

Два редактора правили один абзац книги, каждый по-своему. Корректор не гадает, кто прав: кладёт обе версии рядом и спрашивает автора. Git поступает так же.

Устроим конфликт

Создайте ветку feature/subtitle и поменяйте в index.html подзаголовок — строку <p class="lead">:

$ git switch -c feature/subtitle
Switched to a new branch 'feature/subtitle'
$ git diff
...
-  <p class="lead">Начинающий веб-разработчик</p>
+  <p class="lead">Начинающий веб-разработчик: HTML, CSS и Git</p>
...
$ git add index.html
$ git commit -m "Уточнить подзаголовок"
[feature/subtitle 5162731] Уточнить подзаголовок
 1 file changed, 1 insertion(+), 1 deletion(-)

Теперь представьте, что вы забыли про ветку и поправили ту же строку прямо в main, но по-другому:

$ git switch main
Switched to branch 'main'
$ git diff
...
-  <p class="lead">Начинающий веб-разработчик</p>
+  <p class="lead">Начинающий фронтенд-разработчик</p>
...
$ git add index.html
$ git commit -m "Изменить подзаголовок"
[main a8b0439] Изменить подзаголовок
 1 file changed, 1 insertion(+), 1 deletion(-)
$ git log --oneline --graph --all
* a8b0439 (HEAD -> main) Изменить подзаголовок
| * 5162731 (feature/subtitle) Уточнить подзаголовок
|/
*   d3c03bd Merge branch 'feature/footer'
...

На графе развилка: обе ветки начались от d3c03bd и поменяли одну строку, каждая по-своему.

Сообщение о конфликте

Сливаем, как обычно, стоя на main:

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

Слияние сейчас на паузе. Спросим git status, что происходит:

$ 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 resolution)
	both modified:   index.html

no changes added to commit (use "git add" and/or "git commit -a")

В Git Bash в приглашении терминала рядом с именем ветки появится MERGING — напоминание, что слияние ещё не закончено.

Маркеры конфликта

Откройте index.html в VS Code. В месте конфликта Git вписал прямо в файл обе версии, разделив их специальными строками — маркерами конфликта:

  <h1>Алекс Иванов</h1>
<<<<<<< HEAD
  <p class="lead">Начинающий фронтенд-разработчик</p>
=======
  <p class="lead">Начинающий веб-разработчик: HTML, CSS и Git</p>
>>>>>>> feature/subtitle
  <section id="about">

Маркеры — не HTML: Git вписал их обычным текстом, и в браузере сейчас <<<<<<< HEAD видно прямо на странице. Поэтому все три маркера обязательно удаляют. Конфликтов в файле может быть несколько — ищите их поиском по <<<<<<< (Ctrl+F, на macOS — Cmd+F).

Решаем: правка, add, commit

Решить конфликт — значит оставить в файле ту версию, которая нужна, и убрать маркеры. Что оставить, решаете вы:

Возьмём лучшее из обеих: «фронтенд-разработчик» из main и «HTML, CSS и Git» из ветки. Удалите пять строк от <<<<<<< HEAD до >>>>>>> feature/subtitle включительно и напишите вместо них одну:

  <h1>Алекс Иванов</h1>
  <p class="lead">Начинающий фронтенд-разработчик: HTML, CSS и Git</p>
  <section id="about">

Сохраните файл. Проверьте, что маркеров не осталось, отметьте конфликт решённым и посмотрите статус. Команда grep -n ищет строку в файле и печатает номера найденных строк; пустой ответ — маркеров нет:

$ grep -n "<<<<<<<" index.html
$ git add index.html
$ git status
On branch main
All conflicts fixed but you are still merging.
  (use "git commit" to conclude merge)

Changes to be committed:
	modified:   index.html

Выполните git commit без -m. Откроется редактор с готовым сообщением:

Merge branch 'feature/subtitle'

# Conflicts:
#	index.html
#
# It looks like you may be committing a merge.
# If this is not correct, please run
#	git update-ref -d MERGE_HEAD
# and try again.
...

$ git commit
[main 9a283db] Merge branch 'feature/subtitle'
$ git log --oneline --graph --all
*   9a283db (HEAD -> main) Merge branch 'feature/subtitle'
|\
| * 5162731 (feature/subtitle) Уточнить подзаголовок
* | a8b0439 Изменить подзаголовок
|/
*   d3c03bd Merge branch 'feature/footer'
...
$ git branch -d feature/subtitle
Deleted branch feature/subtitle (was 5162731).

Слияние закончено: merge-коммит 9a283db соединил обе линии, а на главной теперь подзаголовок «Начинающий фронтенд-разработчик: HTML, CSS и Git». Ветку feature/subtitle удаляем, как любую слитую.

То же самое в VS Code

VS Code сам подсвечивает конфликт цветом, а над ним показывает строку действий:

• Accept Current Change — «принять текущее»: оставить версию HEAD (из main);
• Accept Incoming Change — «принять входящее»: оставить версию из сливаемой ветки;
• Accept Both Changes — «принять оба»: оставить обе версии подряд;
• Compare Changes — открыть две версии рядом для сравнения.

Нажатие на действие само удаляет маркеры. Для нашего подзаголовка нажмите Accept Current Change и допишите «: HTML, CSS и Git» руками. В панели Source Control (Ctrl+Shift+G) файлы с конфликтом собраны в разделе Merge Changes; кнопка + (Stage Changes) у файла — то же, что git add.

Слияние и тут завершает коммит: git commit или кнопка Commit в Source Control. Подробно, включая трёхпанельный редактор слияния, — в документации VS Code.

Передумали: git merge --abort

Не уверены, какую версию оставить, или запутались в правках? Слияние можно отменить целиком, пока вы его не закоммитили:

$ git merge --abort
$ git status
On branch main
nothing to commit, working tree clean
$ git log --oneline -1
a8b0439 Изменить подзаголовок

Подробно о том, как Git показывает конфликты, — в документации git merge, раздел HOW CONFLICTS ARE PRESENTED.

Практика у себя

Пройдите путь сами: сначала отменим слияние, потом решим конфликт по-настоящему.

Шаг 1. Сделайте два коммита из раздела «Устроим конфликт»: «Уточнить подзаголовок» в ветке feature/subtitle и «Изменить подзаголовок» в main.

Шаг 2. На main: git merge feature/subtitle — CONFLICT (content): Merge conflict in index.html, в git status — both modified: index.html. Найдите маркеры в файле.

Шаг 3. Отмените: git merge --abort. git status снова чистый.

Шаг 4. Слейте ещё раз, оставьте одну строку <p class="lead">Начинающий фронтенд-разработчик: HTML, CSS и Git</p> без маркеров, сохраните.

Шаг 5. grep -n "<<<<<<<" index.html (пусто), git add index.html, git commit с сообщением из редактора, затем git branch -d feature/subtitle.

Проверьте себя

• git log --oneline --graph начинается с Merge branch 'feature/subtitle', под ним две линии: «Изменить подзаголовок» и «Уточнить подзаголовок».
• В index.html нет ни одной строки с <<<<<<<, ======= или >>>>>>>.
• В браузере под именем один подзаголовок: «Начинающий фронтенд-разработчик: HTML, CSS и Git».
• git status: nothing to commit, working tree clean; git branch показывает только main.

Частые ошибки

Закоммитили маркеры. Обычный git add маркеры не проверяет, и коммит с ними пройдёт — на странице появится <<<<<<< HEAD. Уберите маркеры, выполните git add index.html и новый коммит «Убрать маркеры конфликта». Чтобы не повторилось, перед git add ищите <<<<<<< (grep -n или поиск в VS Code).

Сделали git add до правки. Git поверил вам на слово и пишет All conflicts fixed, хотя маркеры на месте. Пока нет коммита, ничего страшного: поправьте файл, снова git add index.html и только потом git commit.

Коммит без git add. Если сразу выполнить git commit, Git откажет:

$ git commit
error: Committing is not possible because you have unmerged files.
hint: Fix them up in the work tree, and then use 'git add/rm <file>'
hint: as appropriate to mark resolution and make a commit.
fatal: Exiting because of an unresolved conflict.
U	index.html

Не дают переключить ветку. Во время конфликта git switch ответит fatal: cannot switch branch while merging. Сначала закончите слияние коммитом или отмените его git merge --abort.

Что важно запомнить

• Конфликт — когда две ветки поменяли одни и те же строки. Это пауза, а не поломка: обе версии целы.
• Маркеры: <<<<<<< HEAD — начало и версия текущей ветки, ======= — разделитель, >>>>>>> имя-ветки — конец и версия сливаемой ветки.
• Решение: оставить нужный текст, удалить все маркеры, git add, git commit.
• В VS Code: Accept Current Change, Accept Incoming Change, Accept Both Changes — и обязательно проверить результат.
• git merge --abort отменяет слияние целиком, пока нет коммита.
• Сливайте с чистым git status.

Конфликты больше не страшны. Но есть другая частая неприятность: правка в работе, а надо срочно переключиться в другую ветку, и Git не пускает. Как временно убрать незаконченные правки в сторону — git stash, в следующем уроке.