Comment améliorer la lisibilité des diff git avec diff-so-fancy

La lecture des diff Git bruts peut être fatigante. La sortie standard est dense, souvent remplie de plus et de moins, et difficile à parcourir rapidement. Si vous examinez souvent des modifications, rendre les diffs plus lisibles peut vous faire gagner du temps et vous aider à repérer les problèmes plus rapidement.

Dans cet article, nous vous montrerons comment améliorer la lisibilité des diff Git en utilisant diff-so-fancy — un outil conçu pour rendre les diffs plus agréables à l’œil.

Pourquoi la lisibilité des diff Git est importante

Lorsque vous exécutez git diff, Git affiche les modifications avec des symboles comme + et - au début des lignes. Bien que fonctionnel, cela peut être visuellement agressif, surtout pour les modifications de code importantes.

Des diffs difficiles à lire peuvent entraîner des bugs non détectés, des révisions de code plus lentes et une fatigue mentale. Améliorer la façon dont Git affiche les diffs est un petit changement qui a un impact important sur la productivité quotidienne.

Lecture connexe : Comment créer et utiliser des alias Git pour un flux de travail plus rapide

Qu’est-ce que diff-so-fancy ?

diff-so-fancy est un petit utilitaire qui prend la sortie de Git diff et la formate pour une meilleure lisibilité. Il supprime les marqueurs superflus, met en évidence les modifications plus clairement et structure la sortie pour que vous puissiez examiner le code plus rapidement.

Améliorations principales :

• Ajouts et suppressions plus clairs
• Mise en évidence des mots modifiés à l’intérieur des lignes
• En-têtes de sections plus propres
• Regroupement des blocs plus facile à parcourir

Comment installer diff-so-fancy

Vous pouvez installer diff-so-fancy facilement via les gestionnaires de paquets courants.

Sur macOS avec Homebrew :

brew install diff-so-fancy

Sur Ubuntu ou les distributions basées sur Debian :

sudo apt install diff-so-fancy

Ou cloner directement depuis GitHub :

git clone https://github.com/so-fancy/diff-so-fancy.git

Assurez-vous que diff-so-fancy est dans votre chemin système après l’installation.

Comment configurer Git pour utiliser diff-so-fancy

Une fois installé, vous devez indiquer à Git de faire passer les diffs par diff-so-fancy.

Configurez-le avec les commandes de configuration Git suivantes :

git config --global core.pager "diff-so-fancy | less --tabs=4 -RFX"
git config --global interactive.diffFilter "diff-so-fancy --patch"

Cette configuration :

• Fait passer tous les diffs par diff-so-fancy
• Conserve la sortie en couleur
• Rend le comportement de défilement dans less propre et réactif

Vous pouvez également créer un alias Git si vous préférez l’appeler manuellement. Exemple :

git config --global alias.dsf "!git diff --color | diff-so-fancy"

Maintenant, vous pouvez exécuter git dsf à tout moment pour voir un diff plus élégant.

Avant et après : voir la différence

Sortie standard de git diff :

- old line of code
+ new line of code

Avec diff-so-fancy :

• Seules les parties modifiées d’une ligne sont mises en évidence
• Les noms de fichiers et les en-têtes de sections sont plus faciles à parcourir
• Les modifications sont structurées d’une manière qui suit naturellement le regard

Cela vous aide à comprendre rapidement ce qui a changé, sans bruit supplémentaire.

Conclusion

Les petites améliorations de votre flux de travail Git quotidien s’accumulent avec le temps. Configurer Git avec diff-so-fancy rend vos diffs plus faciles à lire, les révisions plus rapides et les erreurs moins probables. Si vous avez apprécié cette amélioration, vous pourriez également trouver utile Utiliser les raccourcis d’URL Git pour accélérer le clonage de dépôts.

FAQ