A quoi sert git format-patch ?

format-patch cree des fichiers patch au format email contenant le diff, le message de commit, l'auteur et la date. C'est le workflow traditionnel pour contribuer au kernel Linux et aux projets open source.

Quelle difference entre format-patch et diff ?

git diff cree un diff brut (juste les modifications). format-patch cree un patch au format email avec les metadonnees du commit (auteur, date, message). Les patches de format-patch s'appliquent avec git am, ceux de diff avec git apply.

Comment envoyer un patch par email ?

Utilise git send-email apres format-patch : git send-email *.patch. Configure d'abord ton serveur SMTP dans git config. Certains projets open source acceptent encore les patches par email.

Comment appliquer un patch recu ?

Utilise git am fichier.patch pour appliquer le patch et creer automatiquement un commit. git am preserve l'auteur, la date et le message du commit original.

Les patches sont-ils encore utilises ?

Oui, surtout dans le kernel Linux et les projets qui n'utilisent pas de forges (GitHub/GitLab). Meme avec les pull requests, format-patch reste utile pour partager des commits sans acces au depot.

Git format-patch : creer des patches par email

git format-patch transforme tes commits en fichiers patch au format email. Le workflow historique de contribution open source, toujours utilise pour le kernel Linux.

Pratiquer git format-patch Glossaire Git

gitquest — enquête

Open source

C'est quoi git format-patch ?

git format-patch convertit des commits en fichiers .patch au format email. Chaque fichier contient le diff, le message de commit, l'auteur et la date.

C'est comme mettre un commit dans une enveloppe : tu peux l'envoyer par email, le partager sur un forum, ou l'appliquer sur un autre depot avec git am.

Syntaxe de git format-patch

git format-patch -1

Patch du dernier commit

git format-patch -3

Patches des 3 derniers commits

git format-patch main..feature

Patches d'une branche entiere

Git format-patch en pratique

Creer et appliquer des patches.

Creer des patches

gitquest — format-patch

# Creer un patch pour le dernier commit

$git format-patch -1

0001-feat-ajouter-le-formulaire.patch

# Creer des patches pour les 3 derniers commits

$git format-patch -3

0001-feat-page-d-accueil.patch

0002-fix-corriger-le-formulaire.patch

0003-feat-ajouter-la-validation.patch

Appliquer avec git am

gitquest — git am

# Creer des patches depuis une branche

$git format-patch main..feature-login

0001-feat-systeme-d-authentification.patch

0002-feat-page-de-login.patch

# Appliquer les patches (avec auteur et message)

$git am *.patch

Applying: feat: systeme d'authentification

Applying: feat: page de login

# Les commits sont recrees avec l'auteur original !

Commandes format-patch essentielles

git format-patch -1

Dernier commit en patch

git format-patch -o dir/

Enregistrer dans un dossier

git format-patch --stdout

Afficher dans le terminal

git am fichier.patch

Appliquer un patch email

git am --abort

Annuler l'application en cours

git send-email *.patch

Envoyer les patches par email

Erreurs courantes avec git format-patch

Appliquer avec apply au lieu de am

Les patches de format-patch contiennent des metadonnees. Utilise git am (pas apply) pour preserver l'auteur et le message de commit.

Oublier l'ordre d'application

Les patches numerotes (0001, 0002...) doivent etre appliques dans l'ordre. Utilise git am *.patch qui les trie automatiquement.

Conflits lors de l'application

Si le code a diverge, resous les conflits puis git am --continue. Ou annule avec git am --abort.

Fait partie du guide Git avance

Commandes liées

git apply

Appliquer un diff brut

git diff

Generer un diff

git log

Voir les commits a patcher

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur git format-patch

Contribue a l'open source avec GitQuest

Apprends les workflows de contribution open source avec les enquetes GitQuest.

Commencer les enquetes