C'est quoi une note Git ?

Une note est une annotation attachee a un commit sans modifier le commit lui-meme. Le hash du commit ne change pas. C'est utile pour ajouter du contexte apres coup : resultats de review, infos de deploiement, etc.

Les notes sont-elles partagees avec push ?

Par defaut, non. Les notes vivent dans refs/notes/commits qui n'est pas pousse automatiquement. Utilise git push origin refs/notes/commits pour les partager, et git fetch origin refs/notes/*:refs/notes/* pour les recuperer.

Pourquoi utiliser des notes au lieu de modifier le message de commit ?

Modifier un message de commit change son hash, ce qui reecrit l'historique. Les notes s'ajoutent sans modifier le commit. C'est important sur les branches partagees ou les commits signes.

Peut-on avoir plusieurs notes par commit ?

Par defaut, un commit a une seule note. Mais tu peux creer des namespaces avec --ref : git notes --ref=review add -m "Approuve". Chaque ref peut avoir sa propre note par commit.

Les notes apparaissent-elles dans git log ?

Oui, git log affiche automatiquement les notes sous le message de commit. Tu peux aussi utiliser --show-notes pour afficher les notes d'un namespace specifique.

Git notes : annoter tes commits

git notes ajoute des annotations a tes commits sans les modifier. Ideal pour le suivi de code review, les infos de deploiement ou tout contexte supplementaire.

Pratiquer git notes Glossaire Git

gitquest — enquête

Annotation

C'est quoi git notes ?

git notes permet d'ajouter des annotations a des commits sans modifier leur hash. Les notes sont stockees separement de l'historique.

C'est comme coller un post-it sur un commit : tu ajoutes du contexte supplementaire (review, deploiement, bug lie) sans toucher au commit original.

Syntaxe de git notes

git notes add -m "texte"

Ajouter une note au dernier commit

git notes show <hash>

Afficher la note d'un commit

git notes remove <hash>

Supprimer une note

Git notes en pratique

Ajouter et gerer des annotations.

Ajouter une note

gitquest — notes add

# Ajouter une note au dernier commit

$git notes add -m "Valide par Marie en code review"

Note ajoutee au commit e4f5g6h

# Voir les notes d'un commit

$git log -1

commit e4f5g6h (HEAD -> main)

feat: ajouter le formulaire

Notes:

Valide par Marie en code review

Gerer les notes

gitquest — notes manage

# Ajouter une note a un commit specifique

$git notes add -m "Deploye en prod le 10/02" a1b2c3d

Note ajoutee

# Modifier une note existante

$git notes edit a1b2c3d

Note mise a jour

# Lister tous les commits avec notes

$git notes list

abc1234 e4f5g6h

def5678 a1b2c3d

# Supprimer une note

$git notes remove e4f5g6h

Note supprimee

Quand utiliser git notes ?

Code review

Annoter les commits avec le statut de review (approuve, demande de modifications) sans modifier l'historique.

Deploiement

Marquer les commits avec les infos de deploiement (date, environnement, version) pour la tracabilite.

Documentation

Ajouter du contexte supplementaire a des commits anciens : liens vers des tickets, explications techniques, etc.

Erreurs courantes avec git notes

Oublier de push les notes

Les notes ne sont pas poussees par defaut. Utilise git push origin refs/notes/commits pour les partager avec l'equipe.

Perdre les notes lors d'un rebase

Un rebase change les hash des commits. Les notes sont liees aux anciens hash et ne suivent pas automatiquement. Utilise git notes copy pour les reassigner.

Ecraser une note existante

Par defaut, git notes add refuse d'ecraser une note existante. Utilise -f pour forcer, ou git notes append pour ajouter a la note existante.

Fait partie du guide Git avance

Commandes liées

git log

Voir les notes dans l'historique

git tag

Marquer des versions importantes

git blame

Voir l'auteur de chaque ligne

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 notes

Documente ton historique avec GitQuest

Apprends a enrichir ton historique Git avec des annotations et du contexte.

Commencer les enquetes