Come unire un ramo Git in un altro

Per unire `feature` in `main`, passa al ramo che riceve i commit, quindi unisci l'altro: `git switch main` seguito da `git merge feature`. Il ramo su cui ti trovi è quello che cambia. Se main non ha nuovi commit, Git lo fa avanzare velocemente. Altrimenti crea un commit di unione e si interrompe se le due parti sono in conflitto.

Come posso unire un ramo passo dopo passo?

# get the latest
git fetch origin

# go to the branch that receives the work
git switch main
git pull --ff-only

# bring the other branch in
git merge feature/search

# publish it
git push

Inizia con un albero pulito: esegui prima il commit o lo stash. Se cambi idea prima o poi, `git merge --abort` ti riporta indietro.

In che direzione va una fusione?

git merge X significa sempre “porta X nel ramo in cui mi trovo”. Quindi l'unione di feature in main viene eseguita da main, mentre l'aggiornamento di feature con l'ultimo main viene eseguito da feature:

# keep a feature branch up to date
git switch feature/search
git fetch origin
git merge origin/main

Che cos'è un'unione rapida?

Se il ramo ricevente non ha commit propri da quando l'altro ramo lo ha lasciato, non c'è nulla da combinare. Git sposta il puntatore del ramo in avanti fino all'ultimo commit dell'altro ramo e non aggiunge alcun commit di unione. La storia rimane una linea retta. Git stampa Fast-forward quando ciò accade.

# before
main:    A---B
              \
feature:       C---D

# after a fast-forward merge
main:    A---B---C---D

Quando entrambi i rami hanno nuovi commit, un avanzamento veloce è impossibile, quindi Git effettua un merge commit con due genitori. La lezione di avanzamento rapido e la lezione sull'unione di rami divergenti mostrano entrambe nella pratica.

Cosa fanno --ff-only, --no-ff e --squash?

git merge --ff-only origin/main
git merge --no-ff feature/search

git merge --squash feature/search
git commit -m "feat(search): quick open"

Cosa succede quando l'unione è in conflitto?

Git si ferma e contrassegna i file in conflitto. Modificali, git add ciascuno, quindi esegui git commit per completare l'unione. Come risolvere i conflitti di unione spiega gli indicatori.

Posso schierarmi automaticamente da una parte?

# take their side wherever hunks conflict
git merge -X theirs feature/search

# take our side wherever hunks conflict
git merge -X ours feature/search

# during a merge, take one side of a whole file
git checkout --theirs path/to/file
git add path/to/file

Dovrei unire o rebase?

Merge mantiene la cronologia esattamente come è avvenuta e non riscrive mai i commit, quindi è sempre al sicuro sui rami condivisi. Rebase riproduce i tuoi commit sopra un altro ramo per una linea retta, ma li riscrive, quindi mantienilo solo sui rami che usi. La lezione sull'unione rispetto al rebase prevede dei compromessi.

Cosa devo fare dopo la fusione?

# check that the branch is fully merged
git branch --merged

# delete it locally and on the remote
git branch -d feature/search
git push origin --delete feature/search

Come eliminare un ramo copre la pulizia. Per annullare un'unione già inviata, vedi come annullare un commit di unione.

Vedi unire rami per ogni opzione.