git status

Instantanés de base

Afficher l’état de vos fichiers de travail et de la zone de préparation

La commande 'git status' montre les fichiers que vous avez modifiés, les modifications préparées pour le prochain commit et les fichiers que Git ne suit pas encore. Elle ne change jamais rien : vous pouvez la lancer à tout moment — lancez-la avant chaque git add et chaque git commit. Elle indique aussi la branche sur laquelle vous êtes et, avec un dépôt distant, votre avance ou votre retard.

Synopsis

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

Options

Cliquez sur une option pour la déplier

Débutant (2)

Produit la sortie au format court : deux lettres d’état par fichier (zone de préparation, puis répertoire de travail).

RecommandéVue compacte au quotidien : deux lettres d’état par fichier

Exemple

git status -s

Afficher la branche et le suivi, même au format court.

RecommandéAjoute la branche et les compteurs d’avance/retard au format court

Exemple

git status -sb

Intermédiaire (1)

Produit une sortie stable et facile à analyser pour les scripts. Elle reste identique d’une version de Git et d’un réglage à l’autre.

Si nécessaireFormat stable, lisible par les scripts

Exemple

git status --porcelain

Choisir la bonne option

Codes du format court

Les deux colonnes de git status -s

CommandeSignification
?? fileNon suivi : Git ne connaît pas le fichier
M fileModifié, non préparé
M fileModifié et préparé
MM filePréparé, puis modifié à nouveau
A fileNouveau fichier, préparé
D fileSupprimé, non préparé

Exemples

Statut complet

git status

Liste les modifications préparées, non préparées et les fichiers non suivis, avec des indications.

Format court

git status -s

Une ligne par fichier avec un code à deux lettres.

Format court avec la branche

git status -sb

Format court, plus la branche et ses compteurs d’avance/retard.

Exemples de workflows

1
git status

Voir ce qui a changé

2
git add app.js

Préparer le fichier voulu

3
git status

Vérifier qu’il est sous "Changes to be committed"

4
git commit -m "Add to cart"

Commit

Dépannage

Un fichier n’apparaît pas dans git status

Cause : Il est listé dans .gitignore, ou il n’a pas changé

Vérifiez avec git check-ignore -v <file> ; les fichiers suivis inchangés ne sont pas listés

git status est lent dans un gros dépôt

Cause : Git parcourt chaque fichier du répertoire de travail

Limitez-le à un dossier : git status src/

Astuces et pièges

Bonnes pratiques

  • ✓Lancez git status avant git add et avant git commit.
  • ✓Lisez les indications : git status affiche la commande qui annule chaque état.
  • ✓Utilisez git status -sb pour une vue compacte qui montre quand même la branche.

Erreurs fréquentes

  • ✗Committer sans vérifier git status et enregistrer des fichiers non voulus.
  • ✗Croire qu’un fichier non suivi sera committé — il faut d’abord l’ajouter.
  • ✗Confondre " M" et "M " : la colonne indique si la modification est préparée.

FAQ

A:

Non. Il lit seulement vos fichiers, la zone de préparation et le dernier commit.

A:

Vos fichiers, la zone de préparation et le dernier commit sont identiques : il n’y a rien à committer.

A:

Vous l’avez préparé, puis modifié à nouveau. C’est la version préparée que le prochain commit enregistrera.