git ls-files
git
Syntaxe
git ls-files [-o|-m|-i] [--exclude-standard]Liste les chemins de l'index et non du disque, ce qui en fait la liste fiable pour un script ; -i ne s'emploie pas seul et réclame -c ou -o avec --exclude-standard.
Options courantes
| Option | Signification |
|---|---|
| -c | files in the index; the default |
| -m | tracked files modified on disk |
| -d | tracked files that are missing |
| -o | files git does not track |
| -i | ignored files; must come with -o or -c and --exclude-standard |
| --exclude-standard | apply .gitignore and friends |
| -s | show mode and object id of each entry |
| -z | separate paths with NUL for xargs -0 |
Exemples
git ls-filesevery tracked path, straight from the index
git ls-files -o --exclude-standarduntracked files only, respecting .gitignore
git ls-files -i -c --exclude-standardtracked files that .gitignore says should be ignored
Ce qui embrouille, c’est qu’annuler a plusieurs formes : déplacer là où pointe une branche n’est pas ajouter un commit qui l’inverse.
Comment lire
- Les crochets [ ] marquent une partie facultative.
- Les points de suspension … signifient qu’on peut en mettre plusieurs.
- Les options sont sensibles à la casse : sur certaines commandes, -r et -R ne font pas la même chose.
Questions fréquentes
Q. Que fait git ls-files ?
Liste les chemins de l'index et non du disque, ce qui en fait la liste fiable pour un script ; -i ne s'emploie pas seul et réclame -c ou -o avec --exclude-standard.
Q. Comment l’écrire ?
git ls-files [-o|-m|-i] [--exclude-standard] — les crochets marquent ce qui est facultatif.
Q. Combien d’options valent la peine ?
Il y en a 8 ici ; la liste complète est dans man git. Cette commande relève de git.
Commandes liées
page man: man git-ls-files