Git status : comment suivre les changements dans votre projet en toute confiance

Comment utiliser git status

Voici une approche pas à pas pour tirer le meilleur parti de git status dans votre flux de travail.

Si vous n’avez pas encore configuré Git, ce guide d’installation vous accompagne dans l’installation et la configuration initiale sur différents systèmes.

Utilisation basique de git status

• Ouvrez votre terminal :

Utilisez votre terminal ou interface en ligne de commande préféré. Vous pourrez ainsi exécuter directement les commandes Git et visualiser en temps réel l’état de votre dépôt.

• Accédez au répertoire de votre projet :

Utilisez la commande cd pour vous déplacer vers le dossier où se trouve votre projet Git.

cd /path/to/your/project

• Exécutez git status :

Une fois dans le répertoire de votre projet, lancez la commande suivante.

git status

Comme nous l’avons vu, Git renvoie une sortie qui inclut généralement :

• Le nom de la branche actuelle.
• La liste des changements indexés et prêts à être commités.
• La liste des fichiers modifiés mais non indexés.
• Tous les fichiers non suivis — de nouveaux fichiers qui n’ont pas encore été ajoutés à Git.

Utiliser le format court

Si vous avez besoin d’un aperçu rapide sans détails superflus, le format court est idéal :

git status --short

Cette vue concise affiche chaque fichier sur une ligne avec des symboles de statut — particulièrement utile pour repérer un changement précis ou intégrer la commande dans un script.

Exemple de sortie :

 M index.html
A  new-script.js
?? temp.txt

Interprétation de la sortie :

• Le premier caractère indique l’état dans la zone d’index.
• Le second caractère indique l’état dans le répertoire de travail.

Comprendre l’option -u de git status

L’option -u (abréviation de --untracked-files) vous permet de contrôler l’affichage des fichiers non suivis dans la sortie — utile pour les projets générant de nombreux fichiers. Voici la signification de chaque mode :

• normal (par défaut)

Affiche les fichiers non suivis dans un format standard et compact.  

Exemple :

git status -u normal

C’est le comportement standard que la plupart des développeurs observent avec git status.

• all

Liste tous les fichiers non suivis — même ceux ignorés par défaut.  

Exemple :

git status -u all

Ce mode offre une visibilité complète — pratique pour déboguer des problèmes de génération de fichiers ou vérifier ce qu’exclut .gitignore.

•  no

Masque les fichiers non suivis pour vous concentrer uniquement sur les changements des fichiers déjà suivis par Git.

Exemple :

git status -u no

Dans l’un de mes plus gros projets — une application Node.js avec un processus de build complexe — la sortie de git status était encombrée de fichiers temporaires, de caches et d’artéfacts de build. L’ajout de l’option -u no m’a permis de me concentrer exclusivement sur les changements des fichiers suivis, sans distractions liées aux fichiers temporaires ou générés automatiquement.

Personnaliser la sortie avec --porcelain

Pour les scripts ou l’automatisation, une sortie prévisible est indispensable. L’option --porcelain fournit un format propre, stable et lisible par machine de git status, idéal pour des outils personnalisés ou des workflows CI/CD :

git status --porcelain

Ce mode imite le format court (--short) mais garantit une sortie cohérente, quelles que soient la version et la configuration de Git. Contrairement au git status par défaut — qui peut inclure des sauts de ligne, des conseils ou de la couleur selon vos réglages — --porcelain supprime toute mise en forme, assurant une analyse fiable par les scripts.

Prochaines étapes après avoir exécuté git status

Après avoir exécuté git status et analysé la sortie, il est temps de décider de la suite — indexer des fichiers, créer un commit ou nettoyer votre répertoire de travail. Voici comment procéder.

Indexer des fichiers pour le commit

L’indexation prépare vos modifications pour inclusion dans le prochain commit. Vous pouvez indexer des fichiers individuellement ou tout d’un coup.

• Indexer un fichier précis :

À utiliser quand vous souhaitez un contrôle fin sur ce qui sera commité.

git add <file-name>

• Indexer tous les changements :

Inclut les fichiers modifiés et nouvellement ajoutés dans le répertoire courant.

git add .

• Indexer uniquement les changements des fichiers suivis (excluant les nouveaux fichiers non suivis) :

git add -u

Je vous recommande de revoir soigneusement les modifications avec git status ou git diff avant l’indexation afin d’éviter d’inclure par erreur des fichiers indésirables. Associer git status à la commande git diff offre une visibilité encore plus fine sur les changements dans vos fichiers.

Créer des commits

Après avoir indexé vos changements, l’étape suivante consiste à créer un commit. Un message de commit clair et descriptif précise non seulement ce qui a changé, mais aussi pourquoi — rendant l’historique du projet plus lisible dans le temps.

git commit -m "Describe your changes here"

Bonnes pratiques pour les messages de commit :

• Utilisez l’infinitif (ex. « Corriger le bug de connexion » plutôt que « Bug de connexion corrigé »).
• Gardez la ligne de résumé sous 50 caractères lorsque c’est possible.
• Si besoin, utilisez un message multi‑lignes (git commit sans -m) pour séparer le résumé de l’explication détaillée.

J’ai appris qu’une minute de plus pour rédiger un message de commit pertinent peut en faire gagner des heures lors des revues ou du débogage. Une fois vos changements validés, envisagez de « squasher » vos commits pour épurer votre historique Git.

Gérer les fichiers non suivis

Les fichiers non suivis peuvent encombrer la sortie de git status, surtout dans les projets avec des artéfacts de build, des journaux ou des répertoires de dépendances. Si vous n’avez pas l’intention de suivre certains fichiers ou dossiers, excluez‑les via un fichier .gitignore à la racine du dépôt.

# Ignore dependency folders and log files
node_modules/
*.log

# Ignore system files
.DS_Store
Thumbs.db

Cela garantit que seuls les fichiers pertinents se trouvent dans votre dépôt et maintient la sortie de git status claire et ciblée. Pour supprimer les fichiers non suivis persistants de votre répertoire de travail, git clean est également un outil intéressant.

Vérifier régulièrement l’état

Lancer fréquemment git status est une habitude simple mais puissante pour garder un flux de développement propre et maîtrisé. En vérifiant régulièrement l’état de votre répertoire de travail et de votre zone d’index — en particulier avant les commits, les changements de branche ou les fusions — vous évitez des erreurs courantes comme commiter des modifications incomplètes ou oublier des fichiers non suivis.

J’ai désormais intégré cette étape à ma routine quotidienne, ce qui a nettement réduit les erreurs dans mon historique de commits.

Dépanner les problèmes courants liés à git status

Même si elle est simple, la sortie de git status peut parfois sembler chargée ou déroutante. Voici quelques problèmes fréquents et comment les gérer.

Fichiers non suivis indésirables

Dans les grands projets — surtout avec divers outils de build — vous pouvez voir apparaître de nombreux fichiers que vous ne souhaitez pas suivre. Dans ce cas, vérifiez votre .gitignore et, si nécessaire, retirez‑les du suivi avec :

git rm --cached <file-name>

Après avoir mis à jour votre .gitignore et utilisé git rm --cached, relancez git status pour vérifier que le fichier n’est plus suivi ni affiché inutilement.

Sortie trop volumineuse

Dans les projets comportant de nombreux fichiers — notamment logs, caches ou ressources temporaires — la sortie de git status peut devenir bruyante et difficile à parcourir, ce qui complique l’identification des changements importants.

Dans ce cas, affichez un résumé concis, une ligne par fichier :

git status --short

Ou masquez complètement les fichiers non suivis dans la sortie :

git status -u no

Ensemble, ces options rendent git status plus ciblé et plus lisible — particulièrement dans de larges bases de code ou des workflows automatisés.

Conclusion

En résumé, git status est un outil indispensable qui vous offre une vue en temps réel sur la santé de votre dépôt. En maîtrisant sa vue par défaut, le format court et des options avancées comme le drapeau -u, vous fluidifiez votre workflow Git et évitez les écueils classiques. Expérimentez ces modes sur vos projets et constatez comment une meilleure lisibilité des changements accélère votre développement.

Si vous débutez avec Git, comprendre git status devient encore plus puissant lorsqu’il est associé à git init, la commande qui initialise les dépôts. Si ce n’est pas déjà fait, découvrez mon tutoriel Git Init pour apprendre comment créer un dépôt de zéro.

Et si vous souhaitez aller plus loin, explorez ces cours DataCamp :

• Intermediate Git – Développez vos compétences avec les techniques de branchement, fusion et résolution de conflits.
• GitHub Foundations – Apprenez à intégrer Git avec GitHub pour des projets collaboratifs.

Bon code — et gardez une parfaite synchronisation avec votre dépôt !