git add |
Ajouter |
|---|---|
| Git | |
Syntaxe
| git add [--verbose | -v] [--dry-run | -n] [--force | -f] [--interactive | -i] [--patch | -p] [--edit | -e] [--[no-]all | --[no-]ignore-removal | [--update | -u]] [--intent-to-add | -N] [--refresh] [--ignore-errors] [--ignore-missing] [--renormalize] [--chmod=(+|-)x] [--pathspec-from-file=file [--pathspec-file-nul]] [--] [pathspec...] |
Paramètres
| Nom | Description |
|---|---|
| pathspec | Ce paramètre permet d'indiquer les fichiers à partir desquels ajouter du contenu. Des fichiers génériques (par exemple *.c) peut être donné pour ajouter tous les fichiers correspondants. Un nom de répertoire principal (par exemple, dir pour ajouter dir/file1 et dir/file2) peut être donné pour mettre à jour l'index afin qu'il corresponde à l'état actuel du répertoire dans son ensemble (par exemple, spécifier dir n'enregistrera pas seulement un fichier dir/file1 modifié dans l'arborescence de travail, un fichier dir/file2 ajouté à l'arborescence de travail, mais aussi un fichier dir/file3 supprimé de l'arborescence de travail). Notez que les anciennes versions de Git ignoraient les fichiers supprimés; utilisez l'option --no-all si vous voulez ajouter des fichiers modifiés ou nouveaux mais ignorer ceux ayant été supprimés. |
| -- | Ce paramètre permet de séparer les options de ligne de commande de la liste des fichiers, (utile lorsque les noms de fichiers peuvent être confondus avec des options de ligne de commande). |
| -A | Ce paramètre permet de mettre à jour l'index non seulement là où l'arborescence de travail a un fichier correspondant à pathspec, mais également là où l'index a déjà une entrée. Il ajoute, modifie et supprime les entrées d'index pour correspondre à l'arborescence de travail. Si aucun pathspec n'est donné lorsque l'option -A est utilisée, tous les fichiers de l'ensemble de l'arborescence de travail sont mis à jour (les anciennes versions de Git utilisait une limite de mise à jour au répertoire courant et à ses sous-répertoires). |
| --all | Ce paramètre permet de mettre à jour l'index non seulement là où l'arborescence de travail a un fichier correspondant à pathspec, mais également là où l'index a déjà une entrée. Il ajoute, modifie et supprime les entrées d'index pour correspondre à l'arborescence de travail. Si aucun pathspec n'est donné lorsque l'option -A est utilisée, tous les fichiers de l'ensemble de l'arborescence de travail sont mis à jour (les anciennes versions de Git utilisait une limite de mise à jour au répertoire courant et à ses sous-répertoires). |
| --chmod=(+|-)x | Ce paramètre permet de remplacer le bit exécutable des fichiers ajoutés. Le bit exécutable n'est modifié que dans l'index, les fichiers sur le disque restent inchangés. |
| --dry-run | Ce paramètre permet de ne pas ajouter réellement le(s) fichier(s), montré simplement s'ils existent et/ou seront ignorés. |
| -e | Ce paramètre permet d'ouvrir le diff par rapport à l'index dans un éditeur et laissez l'utilisateur le modifier. Une fois l'éditeur fermé, ajustez les entêtes des morceaux et appliquez le correctif à l'index. Le but de cette option est de choisir les lignes du correctif à appliquer, voire de modifier le contenu des lignes en staging. Il peut être plus rapide et plus flexible que d'utiliser le sélecteur de morceau interactif. Cependant, il est facile de se confondre et de créer un correctif ne s'appliquant pas à l'index. |
| --edit | Ce paramètre permet d'ouvrir le diff par rapport à l'index dans un éditeur et laissez l'utilisateur le modifier. Une fois l'éditeur fermé, ajustez les entêtes des morceaux et appliquez le correctif à l'index. Le but de cette option est de choisir les lignes du correctif à appliquer, voire de modifier le contenu des lignes en staging. Il peut être plus rapide et plus flexible que d'utiliser le sélecteur de morceau interactif. Cependant, il est facile de se confondre et de créer un correctif ne s'appliquant pas à l'index. |
| -f | Ce paramètre permet d'autoriser l'ajout de fichiers autrement ignorés. |
| --force | Ce paramètre permet d'autoriser l'ajout de fichiers autrement ignorés. |
| -i | Ce paramètre permet d'ajouter le contenu modifié dans l'arborescence de travail de manière interactive à l'index. Des paramètres de chemin facultatifs peuvent être fournis pour limiter le fonctionnement à un sous-ensemble de l'arborescence de travail. |
| --ignore-errors | Ce paramètre permet d'indiquer sii certains fichiers n'ont pas pu être ajoutés en raison d'erreurs d'indexation, de ne pas interrompre l'opération, mais de continuer à ajouter les autres. La commande doit toujours quitter avec un état différent de zéro. La variable de configuration add.ignoreErrors peut être définie sur true pour en faire le comportement par défaut. |
| --ignore-missing | Ce paramètre permet à l'utilisateur de vérifier si l'un des fichiers donnés serait ignoré, peu importe s'ils sont déjà présents dans l'arborescence de travail ou non. Ce paramètre ne peut être utilisée qu'avec --dry-run. |
| --ignore-removal | Ce paramètre permet de mettre à jour l'index en ajoutant de nouveaux fichiers inconnus de l'index et des fichiers modifiés dans l'arborescence de travail, mais d'ignorer les fichiers ayant été supprimés de l'arborescence de travail. Ce paramètre est interdite lorsqu'aucun pathspec n'est utilisé. Ce paramètre est principalement destinée à aider les utilisateurs habitués aux anciennes versions de Git, dont «git add pathspec...» était un synonyme de «git add --no-all pathspec...», c'est-à-dire des fichiers supprimés ignorés. |
| --intent-to-add | Ce paramètre permet d'enregistrer uniquement le fait que le chemin sera ajouté plus tard. Une entrée pour le chemin est placée dans l'index sans contenu. Il est utile, entre autres, pour afficher le contenu non mis en staging de ces fichiers avec git diff et les valider avec git commit -a. |
| --interactive | Ce paramètre permet d'ajouter le contenu modifié dans l'arborescence de travail de manière interactive à l'index. Des paramètres de chemin facultatifs peuvent être fournis pour limiter le fonctionnement à un sous-ensemble de l'arborescence de travail. |
| -n | Ce paramètre permet de ne pas ajouter réellement le(s) fichier(s), montré simplement s'ils existent et/ou seront ignorés. |
| -N | Ce paramètre permet d'enregistrer uniquement le fait que le chemin sera ajouté plus tard. Une entrée pour le chemin est placée dans l'index sans contenu. Il est utile, entre autres, pour afficher le contenu non mis en staging de ces fichiers avec git diff et les valider avec git commit -a. |
| --no-all | Ce paramètre permet de mettre à jour l'index en ajoutant de nouveaux fichiers inconnus de l'index et des fichiers modifiés dans l'arborescence de travail, mais d'ignorer les fichiers ayant été supprimés de l'arborescence de travail. Ce paramètre est interdite lorsqu'aucun pathspec n'est utilisé. Ce paramètre est principalement destinée à aider les utilisateurs habitués aux anciennes versions de Git, dont «git add pathspec...» était un synonyme de «git add --no-all pathspec...», c'est-à-dire des fichiers supprimés ignorés. |
| --no-ignore-removal | Ce paramètre permet de mettre à jour l'index non seulement là où l'arborescence de travail a un fichier correspondant à pathspec, mais également là où l'index a déjà une entrée. Il ajoute, modifie et supprime les entrées d'index pour correspondre à l'arborescence de travail. Si aucun pathspec n'est donné lorsque l'option -A est utilisée, tous les fichiers de l'ensemble de l'arborescence de travail sont mis à jour (les anciennes versions de Git utilisait une limite de mise à jour au répertoire courant et à ses sous-répertoires). |
| --no-warn-embedded-repo | Ce paramètre permet de supprimer l'avertissement (par exemple, si vous effectuez manuellement des opérations sur des sous-modules). Par défaut, git add avertira lors de l'ajout d'un référentiel intégré à l'index sans utiliser git submodule add pour créer une entrée dans .gitmodules. |
| -p | Ce paramètre permet de choisir de manière interactive des morceaux de correctif entre l'index et l'arborescence de travail et de les ajouter à l'index. Il donne à l'utilisateur une chance de revoir la différence avant d'ajouter le contenu modifié à l'index. Il exécute effectivement add --interactive, mais contourne le menu de commande initial et passe directement à la sous-commande patch. |
| --patch | Ce paramètre permet de choisir de manière interactive des morceaux de correctif entre l'index et l'arborescence de travail et de les ajouter à l'index. Il donne à l'utilisateur une chance de revoir la différence avant d'ajouter le contenu modifié à l'index. Il exécute effectivement add --interactive, mais contourne le menu de commande initial et passe directement à la sous-commande patch. |
| --pathspec-file-nul | Ce paramètre permet d'indiquer que les éléments pathspec sont séparés par le caractère NUL et tous les autres caractères sont pris à la lettre (y compris les retours à la ligne et les guillemets). Uniquement significatif avec --pathspec-from-file. |
| --pathspec-from-file=file | Ce paramètre permet de passer pathspec dans file au lieu des paramètres de ligne de commande. Si file est exacte - alors l'entrée standard est utilisée. Les éléments pathspec sont séparés par LF ou CR/LF. Les éléments pathspec peuvent être cités comme pour la variable de configuration core.quotePath. |
| --refresh | Ce paramètre permet de ne pas ajouter le(s) fichier(s), mais d'actualiser uniquement leurs informations stat() dans l'index. |
| --renormalize | Ce paramètre permet d'appliquer le processus de nettoyage fraîchement à tous les fichiers suivis pour les ajouter de force à nouveau à l'index. Il est utile après avoir changé la configuration core.autocrlf ou l'attribut text afin de corriger les fichiers ajoutés avec des fins de ligne CRLF/LF incorrectes. Ce paramètre implique le paramètre -u. |
| -u | Ce paramètre permet de mettre à jour l'index là où il a déjà une entrée correspondant à pathspec. Il supprime et modifie les entrées d'index pour correspondre à l'arborescence de travail, mais n'ajoute aucun nouveau fichier. Si aucun pathspec n'est donné lorsque l'option -u est utilisée, tous les fichiers suivis dans l'ensemble de l'arborescence de travail sont mis à jour (les anciennes versions de Git utilisait une limite de mise à jour au répertoire courant et à ses sous-répertoires). |
| --update | Ce paramètre permet de mettre à jour l'index là où il a déjà une entrée correspondant à pathspec. Il supprime et modifie les entrées d'index pour correspondre à l'arborescence de travail, mais n'ajoute aucun nouveau fichier. Si aucun pathspec n'est donné lorsque l'option -u est utilisée, tous les fichiers suivis dans l'ensemble de l'arborescence de travail sont mis à jour (les anciennes versions de Git utilisait une limite de mise à jour au répertoire courant et à ses sous-répertoires). |
| -v | Ce paramètre permet de demander une sortie détaillés. |
| --verbose | Ce paramètre permet de demander une sortie détaillés. |
Description
Cette commande permet d'ajouter le contenu du fichier à l'index.
Remarques
- La commande git add met à jour l'index en utilisant le contenu actuel trouvé dans l'arborescence de travail, pour préparer le contenu en staging pour la prochaine validation. Il ajoute généralement le contenu actuel des chemins existants dans son ensemble, mais avec certaines options, il peut également être utilisé pour ajouter du contenu avec seulement une partie des modifications apportées aux fichiers de l'arborescence de travail appliquée, ou supprimer les chemins n'existant pas plus dans l'arborescence de travail.
- L'index contient un instantané du contenu de l'arborescence de travail, et c'est cet instantané étant pris comme contenu du prochain commit. Ainsi, après avoir apporté des modifications à l'arborescence de travail et avant d'exécuter la commande git commit, vous devez utiliser la commande git add pour ajouter des fichiers nouveaux ou modifiés à l'index.
- La commande git add peut être exécutée plusieurs fois avant une validation. Il ajoute uniquement le contenu du ou des fichiers spécifiés au moment de l'exécution de la commande d'ajout; si vous voulez que les modifications suivantes soient incluses dans la prochaine validation, vous devez exécuter à nouveau git add pour ajouter le nouveau contenu à l'index.
- La commande git status peut être utilisée pour obtenir un récapitulatif des fichiers dont les modifications sont préparées pour la prochaine validation.
- La commande git add n'ajoutera pas de fichiers ignorés par défaut. Si des fichiers ignorés ont été explicitement spécifiés sur la ligne de commande, git add échouera avec une liste de fichiers ignorés. Les fichiers ignorés atteints par la récursivité du répertoire ou le globbing de nom de fichier effectué par Git (citez vos globs avant l'interpréteur de commande) seront ignorés en silence. La commande git add peut être utilisée pour ajouter des fichiers ignorés avec le paramètre -f (force).
Exemples
L'exemple suivant permet d'ajouter le contenu de tous les fichiers *.txt sous le répertoire gladir et ses sous-répertoires :
| git add gladir/\*.txt |
Notez que l'astérisque * est cité de l'interpréteur de commande dans cet exemple; il permet à la commande d'inclure les fichiers des sous-répertoires du répertoire «gladir/». L'exemple suivant permet de considèrer l'ajout de contenu à partir de tous les scripts git-*.sh :
| git add git-*.sh |
Étant donné que cet exemple permet à l'interpréteur de commande de développer l'astérisque (c'est-à-dire que vous listez les fichiers explicitement), il ne prend pas en compte le subdir/git-foo.sh.
Dernière mise à jour : Mardi, le 5 Janvier 2021