git annotate

Débogage

Annoter les lignes d’un fichier avec les infos de commit (ancien format de blame)

La commande 'git annotate' fait le même travail que git blame — elle indique pour chaque ligne d’un fichier le commit qui l’a modifiée en dernier — mais affiche l’ancien format séparé par des tabulations que certains outils lisent encore. Au quotidien, c’est git blame qu’il faut apprendre.

Synopsis

git annotate [<options>] [<rev>] <file>
[ ] facultatif| ou<arg> valeur à remplacer... répétable--flag option

Exemples

Annoter un fichier

git annotate app.js

Commit, auteur, date et numéro pour chaque ligne.

Exemples de workflows

1
git annotate app.js > app.annotate

Enregistrer la sortie pour l’outil

Dépannage

fatal: no such path 'x' in HEAD

Cause : Le fichier n’est pas suivi

Vérifiez le chemin avec git ls-files

Astuces et pièges

Bonnes pratiques

  • ✓Utilisez git blame dans les nouveaux scripts et au quotidien.

Erreurs fréquentes

  • ✗Apprendre annotate au lieu de blame : blame a plus d’options et un format plus clair.

FAQ

A:

Non, il est conservé pour la compatibilité, mais git blame est la commande documentée et plus riche.