Три способа соединить ветки
Исходное положение: от main отошла ветка feature, и пока в ней шла работа, в main тоже появился коммит.
C ── D feature
/
A ── B ── E main
Слияние (merge). Новый коммит M с двумя родителями. История честная: видно, что работа шла параллельно. Ни один старый коммит не меняется.
C ── D
/ \
A ── B ── E ── M main
Rebase. Коммиты C и D переносятся поверх E и становятся новыми коммитами C′ и D′ — с новыми хэшами. История прямая, как будто работа началась после E.
A ── B ── E ── C′ ── D′ feature (потом main — перемоткой)
Squash. Все коммиты ветки сливаются в один новый S. Кнопка «Squash and merge» на GitHub делает именно это.
A ── B ── E ── S main
Если в main за время работы ничего не появилось, merge ничего не сливает, а перематывает main
вперёд — fast-forward, без нового коммита.
Что выбрать
| Если… | Берём | Почему |
|---|---|---|
своя ветка, ещё не запушена, надо подтянуть свежий main |
git rebase main |
история прямая, конфликты разбираем по одному коммиту |
| ветка уже на GitHub, в ней работают другие | git merge main |
rebase перепишет коммиты, которые есть у других |
готовая задача возвращается в main через pull request |
squash или merge на GitHub | squash — один коммит на задачу; merge — видны все шаги |
git pull и у нас, и на сервере есть новые коммиты |
pull.rebase = true («~/.gitconfig по блокам») |
наши локальные коммиты встают поверх, без коммита «Merge branch ‘main’ of …» |
Ветка на задачу
Создаём ветку от свежего main
git switch main git pull git switch -c traefik-timeouts # Switched to a new branch 'traefik-timeouts'Имя — о чём работа:
traefik-timeouts,fix-crowdsec-hooks. По нему через неделю видно вgit branch, что в ней.Работаем и коммитим
Обычный круг из «Git с нуля»: правка,
git diff,git add,git commit. Коммитов может быть сколько угодно — squash потом сольёт их в один.Подтягиваем свежий main
Пока работали, в
mainчто-то поменялось. Переносим свои коммиты поверх:git fetch git rebase origin/main # Successfully rebased and updated refs/heads/traefik-timeouts.Ветка уже на GitHub и в ней работает ещё кто-то — вместо rebase
git merge origin/main.Возвращаем в main
Без pull request, у себя:
git switch main git merge --ff-only traefik-timeouts git push--ff-only— только перемотка: еслиmainуспел уйти вперёд, git откажет, и мы вернёмся к шагу 3, а не получим случайный коммит слияния.Через GitHub —
git push, pull request, кнопка слияния. Потом локальноgit switch main && git pull.Удаляем ветку
git branch -d traefik-timeouts git push origin --delete traefik-timeouts # если она была на GitHubПосле squash на GitHub
-dоткажет: коммиты ветки попали вmainпод другим хэшем (см. «Если не работает»).
Конфликт
Обе ветки поменяли одну строку: в main порт стал 9090, в feature — 8080.
Читаем, что сказал git
Auto-merging app.yml CONFLICT (content): Merge conflict in app.yml Automatic merge failed; fix conflicts and then commit the result.При rebase то же самое, плюс какой коммит не встал и что делать дальше:
error: could not apply 7931637... feature port hint: Resolve all conflicts manually, mark them as resolved with hint: "git add/rm <conflicted_files>", then run "git rebase --continue". hint: You can instead skip this commit: run "git rebase --skip". hint: To abort and get back to the state before "git rebase", run "git rebase --abort".Смотрим, какие файлы в конфликте
git status # 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: app.ymlПравим файл
С
merge.conflictStyle = zdiff3(«~/.gitconfig по блокам») в файле три версии:name: site <<<<<<< HEAD port: 9090 ||||||| 217e8ca port: 80 ======= port: 8080 >>>>>>> feature workers: 2Сверху — текущая ветка (
HEAD), посередине — как было у общего предка, снизу — вливаемая ветка. По предку видно: было 80, обе стороны его поменяли, каждая по-своему. Решаем, какое значение верное, или собираем из двух. Оставляем одну строкуport: …, все маркеры<<<<<<<,|||||||,=======,>>>>>>>удаляем.Целиком одну сторону берём без правки руками:
Что берём При merge При rebase версию ветки, в которой стоим git checkout --ours app.ymlgit checkout --theirs app.ymlверсию вливаемой ветки git checkout --theirs app.ymlgit checkout --ours app.ymlПри rebase стороны перевёрнуты: git стоит на
mainи по одному накладывает наши коммиты, поэтому «ours» — этоmain, а «theirs» — наш коммит.Отмечаем и продолжаем
grep -n '^<<<<<<<\|^>>>>>>>' app.yml || echo "маркеров нет" git add app.yml git commit # при merge git rebase --continue # при rebase — до следующего коммита или до концаОшиблись в разборе или передумали —
git merge --abortилиgit rebase --abort: всё вернётся к состоянию до начала.
Если не работает
error: cannot rebase: You have unstaged changes. error: Please commit or stash them.
- Причина
- В рабочем каталоге незакоммиченные правки, а rebase переключает файлы.
- Делаем
git stash, rebase,git stash pop— или один разrebase.autoStash = true(«~/.gitconfig по блокам»).
CONFLICT (content): Merge conflict in app.yml
- Причина
- Обе ветки поменяли одни и те же строки, и git не знает, чья правка верная.
- Делаем
- Разбираем по шагам из раздела «Конфликт». Передумали —
git merge --abortилиgit rebase --abort, всё вернётся как было.
Во время rebase --ours взял не ту версию
- Причина
- В rebase стороны меняются местами: «ours» — ветка, на которую переносим (
main), «theirs» — наш переносимый коммит. - Делаем
- Во время rebase своё —
git checkout --theirs app.yml; при merge своё —--ours.
error: the branch 'feature' is not fully merged
- Причина
git branch -dзащищает от удаления ветки с коммитами, которых нет в текущей ветке. После squash-слияния на GitHub так выглядит любая ветка: её коммиты вmainпод другими хэшами.- Делаем
- Проверяем, что правки в
mainесть (git log main --oneline -5), и удаляемgit branch -D feature.
После rebase git push отказывает: ! [rejected] … (non-fast-forward)
- Причина
- Rebase переписал коммиты, которые уже были на GitHub: у них новые хэши.
- Делаем
- Если ветка только наша —
git push --force-with-lease(«push --force-with-lease вместо --force»). Если в ней работают другие — rebase не делаем, только merge.
Как проверить
История после слияния — граф:
git log --oneline --graph -8
# * 3e2d1c (HEAD -> main, origin/main) traefik: readTimeout 300s
# * 9f8e7d traefik: таймаут на чтение — в отдельный блок
# * a1b2c3 crowdsec: хук forward
Прямая линия без |\ и |/ — rebase или перемотка; развилка со звёздочкой слияния — merge. В файлах
не осталось маркеров конфликта:
git grep -n '^<<<<<<< ' || echo "чисто"
# чисто