Comment vérifier si un fichier est suivi par Git

Introduction

Dans ce laboratoire (lab), vous apprendrez à vérifier si un fichier est suivi par Git. Nous allons explorer deux commandes Git essentielles : git ls-files et git status.

Vous utiliserez d'abord git ls-files pour lister tous les fichiers actuellement suivis par Git dans votre dépôt (repository). Ensuite, vous utiliserez git status pour vérifier l'état de suivi et comprendre comment Git indique l'état de votre répertoire de travail lorsque tous les changements ont été validés (committed). Enfin, vous testerez comment Git gère les fichiers non suivis.

Skills Graph

Exécuter git ls-files pour vérifier un fichier

Dans cette étape, nous allons utiliser la commande git ls-files pour voir quels fichiers Git suit actuellement dans notre dépôt (repository). Cette commande est utile pour avoir un aperçu rapide des fichiers qui font partie de l'historique de votre projet.

Tout d'abord, assurez-vous que vous êtes dans le répertoire my-time-machine. Si ce n'est pas le cas, utilisez la commande cd pour vous y rendre :

cd ~/project/my-time-machine

Maintenant, exécutez la commande git ls-files :

git ls-files

Étant donné que nous avons déjà créé et validé (committed) le fichier message.txt dans les étapes précédentes, vous devriez voir le nom de ce fichier dans la sortie :

message.txt

La commande git ls-files liste tous les fichiers actuellement suivis par Git dans votre dépôt. Ce sont les fichiers que Git surveille activement pour détecter les modifications et qui sont inclus dans vos validations (commits).

Comprendre quels fichiers sont suivis est important car Git ne gère que l'historique des fichiers suivis. Tous les fichiers non suivis seront ignorés par Git lorsque vous effectuerez des validations. Cela vous donne le contrôle sur ce qui est inclus dans l'historique des versions de votre projet.

Dans les étapes suivantes, nous explorerons comment Git gère les fichiers qui ne sont pas encore suivis.

Utiliser git status pour vérifier le suivi

Dans l'étape précédente, nous avons utilisé git ls-files pour constater que message.txt est un fichier suivi. Maintenant, utilisons à nouveau la commande git status pour voir comment Git indique l'état de notre dépôt lorsque tous les changements ont été validés (committed).

Assurez-vous que vous êtes toujours dans le répertoire ~/project/my-time-machine.

Exécutez la commande git status :

git status

Vous devriez voir une sortie similaire à celle-ci :

On branch master
nothing to commit, working tree clean

Cette sortie nous apprend quelques informations importantes :

• "On branch master" : Nous sommes toujours sur la branche principale (main timeline) de notre projet.
• "nothing to commit, working tree clean" : C'est la partie essentielle. Cela signifie qu'il n'y a pas de modifications dans notre répertoire de travail qui nécessitent d'être validées. Git constate que l'état actuel des fichiers correspond à l'état du dernier commit.

Cet état est idéal pour votre dépôt lorsque vous avez terminé une série de modifications et les avez validées. Cela indique que votre répertoire de travail est "propre" et synchronisé avec le dernier commit.

En comparant cette sortie à celle de git status que nous avons vue avant de créer message.txt et de le valider, vous pouvez voir comment le message d'état de Git change pour refléter l'état de vos fichiers et de vos commits.

Dans l'étape suivante, nous allons introduire un nouveau fichier pour voir comment l'état de Git change lorsqu'il y a des fichiers non suivis.

Tester les fichiers non suivis

Dans cette étape, nous allons créer un nouveau fichier dans notre répertoire my-time-machine et voir comment l'état de Git change pour indiquer la présence d'un fichier non suivi.

Assurez-vous que vous êtes dans le répertoire ~/project/my-time-machine.

Créez un nouveau fichier appelé notes.txt en utilisant la commande echo :

echo "Some random notes" > notes.txt

Cette commande crée un nouveau fichier nommé notes.txt et écrit le texte "Some random notes" à l'intérieur.

Maintenant, vérifions à nouveau l'état de notre dépôt en utilisant git status :

git status

Vous devriez voir une sortie similaire à celle-ci :

On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        notes.txt

nothing added to commit but untracked files present (use "git add" to track)

Remarquez la section "Untracked files:" (Fichiers non suivis). Git a détecté le nouveau fichier notes.txt, mais nous indique qu'il n'est pas suivi. C'est parce que nous n'avons pas encore indiqué à Git d'inclure ce fichier dans l'historique de notre dépôt.

Ceci est un concept clé dans Git : vous devez explicitement indiquer à Git quels fichiers vous souhaitez suivre en utilisant la commande git add. Cela empêche Git d'inclure automatiquement tous les fichiers de votre répertoire, qui pourraient inclure des fichiers temporaires, des artefacts de construction ou des notes personnelles que vous ne souhaitez pas inclure dans l'historique de votre projet.

Dans le prochain laboratoire (lab), nous apprendrons comment ajouter ce nouveau fichier à la zone de préparation (staging area) et le valider (commit), le rendant ainsi un fichier suivi dans notre dépôt.

Résumé

Dans ce laboratoire (lab), nous avons appris à vérifier si un fichier est suivi par Git. Nous avons utilisé la commande git ls-files pour lister tous les fichiers actuellement suivis dans le dépôt, confirmant que message.txt était suivi.

Nous avons ensuite utilisé la commande git status pour vérifier l'état du dépôt. La sortie "nothing to commit, working tree clean" (Rien à valider, l'arbre de travail est propre) indiquait que tous les changements avaient été validés (committed) et qu'il n'y avait pas de fichiers non suivis ni de modifications en attente dans le répertoire de travail. Cela a renforcé notre compréhension de la façon dont Git indique l'état des fichiers suivis.