Comment créer et appliquer un patch dans Git

Pour créer un correctif, exécutez `git diff > fix.patch` pour les modifications non validées ou `git format-patch -1 HEAD` pour votre dernière validation. Pour en appliquer un, exécutez `git apply fix.patch` ou `git am 0001-my-change.patch`. Utilisez git apply lorsque vous souhaitez uniquement les modifications dans votre dossier de travail. Utilisez git am lorsque vous voulez le commit original, avec son message et son auteur.

Qu'est-ce qu'un correctif Git ?

Un patch est un fichier texte répertoriant les lignes à supprimer et à ajouter dans quels fichiers. Cela convient aux moments où vous ne pouvez pas pousser vers le même dépôt distant : envoyer un correctif par e-mail, déplacer une modification entre des référentiels non liés ou conserver une modification locale en dehors du contrôle de version. Lorsque vous et l’autre personne partagez un dépôt distant, une branche est plus simple.

Comment créer un correctif à partir de modifications non validées ?

# 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

Les nouveaux fichiers qui ne sont pas préparés n'apparaissent pas dans git diff. Exécutez d'abord git add sur eux et utilisez --staged.

Comment créer un patch à partir de commits ?

# 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 écrit des fichiers nommés comme 0001-add-search-box.patch. Chacun conserve le message, l'auteur et la date du commit, qu'un simple git diff perd.

Comment appliquer un patch ?

Vérifiez-le d'abord. Ces deux commandes ne changent rien :

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

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

Ensuite, appliquez-le comme vous en avez besoin :

# 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

Quelle est la différence entre git apply et git am ?

Comment puis-je corriger « le correctif ne s'applique pas » ?

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

Le fichier a changé depuis la création du correctif, donc ses lignes de contexte ne correspondent plus. Essayez-les dans l'ordre :

1. git apply --3way fix.patch utilise les blobs d'origine pour fusionner et laisse les marqueurs de conflit normaux. Il a besoin de ces blobs dans votre référentiel.
2. git apply --whitespace=fix fix.patch est utile lorsque seuls les espaces ou les fins de ligne diffèrent.
3. git apply --reject fix.patch applique ce qu'il peut et écrit les pièces défaillantes dans .rej fichiers pour que vous puissiez le faire à la main.
4. Vérifiez le commit à partir duquel le patch a été créé, appliquez-le là, puis rebasez.

Pour git am, utilisez git am --3way, résolvez le conflit, git add le fichier et exécutez git am --continue. Pour revenir en arrière, exécutez git am --abort, comme indiqué dans comment abandonner une fusion ou un rebase.

Comment annuler un patch ?

git apply -R fix.patch

-R applique le correctif à l'envers. Si vous avez utilisé git am, les commits sont des commits normaux, alors annulez-les avec `git reset` ou `git revert`.

Le guide de création et application de correctifs répertorie toutes les options.