git status

Définition

La commande git status affiche l'état du répertoire de travail et de la zone de préparation. Elle permet de voir les modifications préparées et les fichiers qui ne sont pas suivis par Git. La sortie de git status n'affiche aucune information sur l'historique des validations du projet. À cette fin, utilisez la commande git log. git status affiche simplement ce qui a été fait avec les commandes git add et git commit.

Utilisation

La commande git status liste les fichiers préparés, non préparés et non suivis.

git status

git status

Options courantes

-s ou --short	Affiche au format court.
-b ou --branch	Affiche les informations de branche et de suivi au format court.
--porcelain	Affiche au format facile à analyser pour les scripts. Il reste stable entre les versions de Git et ne tient pas compte de la configuration utilisateur.
--long	Affiche au format long (par défaut).
-u<code><mode></code> ou --untracked-files[=<mode>]	Affiche les fichiers non suivis. Le paramètre mode est optionnel et sert à gérer les fichiers non suivis. Les options possibles sont : no - n'affiche aucun fichier non suivi. normal - affiche les fichiers et répertoires non suivis. all - affiche également les fichiers individuels dans les répertoires non suivis.
--ignore-submodules[=<when>]	Ignore les modifications des sous-modules lors de la recherche de changements. <when> peut être "none", "untracked", "dirty" ou "all".
--ignored	Affiche les fichiers ignorés.
-z	Termine les entrées par un caractère NUL. Si aucun format n'est spécifié, le format de sortie --porcelain est utilisé.
--column[=<options>] ou --no-column	Affiche les fichiers non suivis en colonnes. Si aucune option n'est utilisée, --column et --no-column sans options sont équivalents à always et never.

Ignorer des fichiers

Les fichiers non suivis peuvent être de deux types : ceux qui n'ont pas été ajoutés et validés dans le projet, et ceux qui sont des binaires comme .pyc, .obj, .exe, etc. Si les binaires sont inclus dans la sortie de git status, vous ne pouvez pas voir l'état réel de votre dépôt. Ainsi, Git ajoute les chemins dans le fichier .gitignore pour ignorer ces fichiers. Ceux que vous ne souhaitez pas ignorer seront inclus sur une ligne séparée. Le symbole \* est utilisé comme caractère générique :

git status : ignorer des fichiers

*.obj

Explication

Il est très important de vérifier l'état du dépôt avant de valider tout changement. L'exemple suivant montre l'état du dépôt avant et après la préparation et la validation :

exemple de git status

# Edit w3docs.txt
git status
# w3docs.txt is listed under "Changes not staged for commit"
git add w3docs.txt
git status
# w3docs.txt is listed under "Changes to be committed"
git commit
git status
# nothing to commit (working directory clean)

Le premier statut affiche le fichier non préparé. Dans le deuxième statut, l'action git add est suivie. La troisième sortie de statut indique qu'il n'y a rien à valider.

Pratique

Quelles informations la commande 'git status' fournit-elle ?

Elle affiche l'état du répertoire de travail et de la zone de préparation, y compris les modifications préparées et les fichiers non suivis par Git.Elle affiche l'historique des validations du projet.Elle liste uniquement les fichiers actuellement suivis par Git.Elle affiche les différences entre le répertoire de travail et la dernière validation.