basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Ветки в git: слияние, rebase и конфликты по шагам

    Ветка на задачу, работа в ней, обновление от main и возврат в main — слиянием или rebase. Что выбрать, когда и как разобрать конфликт, не потеряв ни свою, ни чужую правку. Главное правило rebase: переписываем только то, что ещё не запушили.

    Три способа соединить ветки

    Исходное положение: от 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 …»

    Ветка на задачу

    1. Создаём ветку от свежего 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, что в ней.

    2. Работаем и коммитим

      Обычный круг из «Git с нуля»: правка, git diff, git add, git commit. Коммитов может быть сколько угодно — squash потом сольёт их в один.

    3. Подтягиваем свежий main

      Пока работали, в main что-то поменялось. Переносим свои коммиты поверх:

      git fetch
      git rebase origin/main
      # Successfully rebased and updated refs/heads/traefik-timeouts.

      Ветка уже на GitHub и в ней работает ещё кто-то — вместо rebase git merge origin/main.

    4. Возвращаем в 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.

    5. Удаляем ветку

      git branch -d traefik-timeouts
      git push origin --delete traefik-timeouts     # если она была на GitHub

      После squash на GitHub -d откажет: коммиты ветки попали в main под другим хэшем (см. «Если не работает»).

    Конфликт

    Обе ветки поменяли одну строку: в main порт стал 9090, в feature — 8080.

    1. Читаем, что сказал 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".
    2. Смотрим, какие файлы в конфликте

      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
    3. Правим файл

      С 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.yml git checkout --theirs app.yml
      версию вливаемой ветки git checkout --theirs app.yml git checkout --ours app.yml

      При rebase стороны перевёрнуты: git стоит на main и по одному накладывает наши коммиты, поэтому «ours» — это main, а «theirs» — наш коммит.

    4. Отмечаем и продолжаем

      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 "чисто"
    # чисто