Cómo fusionar una rama de Git con otra

Para fusionar `feature` en `main`, cambie a la rama que recibe las confirmaciones, luego fusione la otra: `git switch main` seguida de `git merge feature`. La rama en la que se encuentra es la que cambia. Si main no tiene nuevas confirmaciones, Git lo adelanta. De lo contrario, crea una confirmación de fusión y se detiene si las dos partes entran en conflicto.

¿Cómo fusiono una rama paso a paso?

# 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

Comience con un árbol limpio: confirme o guarde primero. Si cambias de opinión parcialmente, `git merge --abort` te lleva de regreso.

¿Hacia dónde va una fusión?

git merge X siempre significa "traer X a la rama en la que estoy". Entonces, fusionar feature en main se realiza desde main, mientras que actualizar feature con el último main se realiza desde feature:

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

¿Qué es una fusión rápida?

Si la rama receptora no tiene confirmaciones propias desde que la otra rama la abandonó, no hay nada que combinar. Git mueve el puntero de la rama hacia la última confirmación de la otra rama y no agrega ninguna confirmación de fusión. La historia sigue una línea recta. Git imprime Fast-forward cuando esto sucede.

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

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

Cuando ambas ramas tienen nuevas confirmaciones, es imposible realizar un avance rápido, por lo que Git realiza una confirmación de fusión con dos padres. La lección de avance rápido y la lección sobre fusionar ramas divergentes muestran ambas en la práctica.

¿Qué hacen --ff-only, --no-ff y --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"

¿Qué sucede cuando la fusión entra en conflicto?

Git detiene y marca los archivos en conflicto. Edítelos, git add cada uno, luego ejecute git commit para finalizar la combinación. Cómo resolver conflictos de fusión explica los marcadores.

¿Puedo tomar un lado automáticamente?

# 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

¿Debería fusionarme o cambiar de base?

Merge mantiene el historial exactamente como sucedió y nunca reescribe las confirmaciones, por lo que siempre es seguro en ramas compartidas. Rebase reproduce tus confirmaciones encima de otra rama en línea recta, pero las reescribe, así que mantenlo en las ramas que solo uses. La lección de fusión versus rebase pasa por las compensaciones.

¿Qué debo hacer después de fusionarme?

# 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

Cómo eliminar una rama cubre la limpieza. Para revertir una combinación que ya está enviada, consulte cómo revertir una confirmación de combinación.

Consulte fusionar ramas para cada opción.