git ls-files
git
Uso
git ls-files [-o|-m|-i] [--exclude-standard]Lista rutas del índice, no del disco, y por eso es la lista fiable para un script; -i no funciona solo y exige -c u -o junto con --exclude-standard.
Opciones habituales
| Opción | Significado |
|---|---|
| -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 |
Ejemplos
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
Lo confuso es que deshacer tiene varias formas: mover a dónde apunta una rama no es lo mismo que añadir un commit que la revierte.
Cómo leerlo
- Los corchetes [ ] marcan una parte que puedes omitir.
- Los puntos suspensivos … indican que puedes poner varios.
- Las opciones distinguen mayúsculas: en algunos comandos -r y -R no hacen lo mismo.
Preguntas
Q. ¿Qué hace git ls-files?
Lista rutas del índice, no del disco, y por eso es la lista fiable para un script; -i no funciona solo y exige -c u -o junto con --exclude-standard.
Q. ¿Cómo se escribe?
git ls-files [-o|-m|-i] [--exclude-standard] — los corchetes marcan lo que puedes omitir.
Q. ¿Cuántas opciones vale la pena saber?
Aquí van 8; la lista completa está en man git. Este comando está en git.
Comandos relacionados
página man: man git-ls-files