Ajouter des fichiers avec Git : Guide pratique

Qu'est-ce que le Git Add ?

Dans l'univers de Git, la commande add possède une importance capitale. Elle permet de transférer les modifications que vous avez effectuées dans votre working tree (l'espace de travail) vers la staging area (la zone de staging). Cette zone est un espace temporaire où Git enregistre les changements qui seront intégrés lors du prochain commit. Lorsqu'un fichier est suivi par Git et qu'il est prêt à être inclus dans le prochain commit, son nom apparaît en vert, signalant qu'il est maintenant sous contrôle de version.

Exemple d'utilisation de git add

Prenons un exemple concret. Supposons que vous ayez modifié un fichier nommé message.txt. Si vous exécutez la commande suivante pour vérifier l'état de votre dépôt, vous obtiendrez ceci :

$ git status
On branch main
No commits yet
Untracked files:  (use "git add ..." to include in what will be committed)  message.txt
nothing added to commit but untracked files present (use "git add" to track)

Ici, message.txt est un fichier non suivi. Pour l'ajouter à la zone de staging, exécutez la commande suivante :

$ git add message.txt
$ git status
On branch main
No commits yet
Changes to be committed:  (use "git rm --cached ..." to unstage)  new file:   message.txt

Après avoir ajouté le fichier, message.txt apparaît en vert, ce qui indique qu'il est maintenant en attente d'un commit.

Variantes de la commande git add

Il existe plusieurs options que vous pouvez utiliser avec la commande git add :

  • -n : Cette option permet de vérifier si un fichier existe ou s'il est ignoré sans l'ajouter à la zone de staging.
  • -f : Utilisée pour forcer l’ajout de tous les fichiers, y compris ceux qui sont normalement ignorés.
  • . : Pour ajouter tous les fichiers du répertoire courant, cette commande fait référence à la localisation actuelle dans le terminal.
  • -A : Cette variante ajoute tous les fichiers tant du répertoire courant que de ses sous-répertoires.
    Chacune de ces options peut s'avérer utile selon le contexte de votre travail.