Cómo crear y aplicar un parche en Git

Para crear un parche, ejecute `git diff > fix.patch` para cambios no confirmados o `git format-patch -1 HEAD` para su última confirmación. Para aplicar uno, ejecute `git apply fix.patch` o `git am 0001-my-change.patch`. Utilice git apply cuando solo desee los cambios en su carpeta de trabajo. Utilice git am cuando desee la confirmación original, con su mensaje y autor.

¿Qué es un parche Git?

Un parche es un archivo de texto que enumera qué líneas eliminar y agregar en qué archivos. Es adecuado para momentos en los que no se puede enviar al mismo remoto: enviar una corrección por correo electrónico, mover un cambio entre repositorios no relacionados o mantener un cambio local fuera del control de versiones. Cuando usted y la otra persona comparten un remoto, una rama es más sencilla.

¿Cómo creo un parche a partir de cambios no confirmados?

# unstaged changes
git diff > fix.patch

# staged changes
git diff --staged > fix.patch

# everything since the last commit
git diff HEAD > fix.patch

# include binary files
git diff --binary > fix.patch

Los archivos nuevos que no están preparados no aparecen en git diff. Ejecute git add en ellos primero y use --staged.

¿Cómo creo un parche a partir de confirmaciones?

# the last commit
git format-patch -1 HEAD

# the last three commits, one file each
git format-patch -3

# everything on this branch that main does not have
git format-patch main..feature/search -o patches/

# all of it in a single file
git format-patch main --stdout > feature.patch

format-patch escribe archivos con nombres como 0001-add-search-box.patch. Cada uno conserva el mensaje, el autor y la fecha de la confirmación, que un simple git diff pierde.

¿Cómo aplico un parche?

Compruébalo primero. Estos dos comandos no cambian nada:

# what it touches
git apply --stat fix.patch

# whether it will apply
git apply --check fix.patch

Luego aplícalo de la forma que necesites:

# into the working folder, nothing staged
git apply fix.patch

# into the working folder and the staging area
git apply --index fix.patch

# as commits, with their messages and authors
git am patches/*.patch

¿Cuál es la diferencia entre git apply y git am?

¿Cómo soluciono "el parche no se aplica"?

error: patch failed: src/search.ts:14
error: src/search.ts: patch does not apply

El archivo cambió desde que se realizó el parche, por lo que sus líneas de contexto ya no coinciden. Pruebe estos en orden:

1. git apply --3way fix.patch usa los blobs originales para fusionarse y deja marcadores de conflicto normales. Necesita esos blobs en su repositorio.
2. git apply --whitespace=fix fix.patch ayuda cuando solo difieren los espacios o los finales de línea.
3. git apply --reject fix.patch aplica lo que puede y escribe las partes fallidas en .rej archivos para que usted pueda hacerlo a mano.
4. Verifique la confirmación a partir de la cual se creó el parche, aplíquelo allí y luego vuelva a crear la base.

Para git am, use git am --3way, resuelva el conflicto, git add el archivo y ejecute git am --continue. Para retroceder, ejecute git am --abort, como se indica en cómo cancelar una combinación o rebase.

¿Cómo deshago un parche?

git apply -R fix.patch

-R aplica el parche al revés. Si usó git am, las confirmaciones son confirmaciones normales, así que deshagalas con `git reset` o `git revert`.

La guía para crear y aplicar parches enumera todas las opciones.