git-status - Muestra el estatus del árbol de trabajo

Muestra las rutas que tienen diferencias entre el fichero índice y la HEAD de la confirmación actual, las rutas que tengan diferencias entre el árbol de trabajo y el fichero índice, y las rutas en el árbol de trabajo sin seguimiento de Git (y no son ignoradas por gitignore[5]). Las primeras son las que querrías confirmar ejecutando git commit; las segundas y terceras son las que podrías confirmar ejecutando git add antes de git commit.

La salida de este comando esta diseñada para usarse como una plantilla de comentario de confirmación. El predeterminado, formato largo, esta diseñado para ser legible al humano y descriptivo. Su contenido y formato están sujetos a cambio en cualquier momento.

Las rutas mencionadas en la salida, al contrario de muchos otros comandos Git, se hacen relativas al directorio actual si se trabaja en un subdirectorio (esto es a propósito, para ayudar al copiado y pegado). Ver la opción de configuración status.relativePaths más abajo.

El comando respeta las variables de configuración color.status (o status.color — significa lo mismo y la última se mantiene por retrocompatibilidad) y color.status <slot> para coloresr la salida.

Si la variable de configuración status.relativePaths se establece a falso, todas las rutas mostradas son relativas a la raíz del repositorio, no del directorio actual.

Si status.submoduleSummary se establece en un número distinto de cero o en Verdadero (lo que equivale a -1 o a un número ilimitado), se habilitará el resumen de submódulos en formato extenso y se mostrará un resumen de las confirmaciones de los submódulos modificados (véase la opción --summary-limit de git-submodule[1]). Ten en cuenta que la salida del resumen del comando status se suprimirá para todos los submódulos cuando diff.ignoreSubmodules esté establecido en all, o solo para aquellos submódulos en los que submodule.<nombre>.ignore=all. Para ver también el resumen de los submódulos ignorados, puedes utilizar la opción de línea de comandos --ignore-submodules=dirty o el comando git submodule summary, que muestra un resultado similar pero no tiene en cuenta esta configuración.

Por defecto, git status actualiza automáticamente el índice, actualizando la información de estado almacenada en caché a partir del árbol de trabajo y escribiendo el resultado. Escribir el índice actualizado es una optimización que no es estrictamente necesaria (status calcula los valores por sí mismo, pero los escribe únicamente para evitar que los programas posteriores tengan que repetir nuestro cálculo). Cuando se ejecuta status en segundo plano, el bloqueo que se mantiene durante la escritura puede entrar en conflicto con otros procesos simultáneos, lo que provocaría que estos fallaran. Los scripts que ejecuten status en segundo plano deberían plantearse utilizar git --no-optional-locks status (véase git[1] para más detalles).

git status puede resultar muy lento en árboles de trabajo de gran tamaño cuando tiene que buscar ficheros y directorios sin seguimiento. Existen numerosas opciones de configuración que permiten acelerar este proceso, ya sea evitando dicho trabajo o aprovechando los resultados almacenados en caché de comandos Git anteriores. No existe un único conjunto de ajustes óptimo que sea adecuado para todo el mundo. A continuación te ofrecemos un resumen de las opciones relevantes para ayudarte, pero antes de pasar a la lista, quizá te interese volver a ejecutar git status, ya que es posible que tu configuración ya tenga almacenados en caché los resultados de git status, por lo que podría ser más rápido en ejecuciones posteriores.

Considera que después de que actives la caché sin seguimiento y/o las características de FSMonitor, puede tomar algunos comandos git status para calentar las distintas caches, antes de notar mejores tiempos de comando. Esto es normal.

gitignore[5]

Parte de la suite de git[1]