Tema 5 · Diagnóstico

Inspeccionar el Estado: git status y su Lectura

Aprende a interpretar cada sección de la salida de git status: archivos sin seguimiento (Untracked), modificados (Modified), preparados (Staged) y la versión concisa con git status -s.

El Comando más Usado en la Historia de Git

git status es tu brújula permanente. Te informa exactamente qué está pasando en tu proyecto en este preciso instante: en qué rama te encuentras, si estás al día con el servidor remoto, qué archivos has modificado y cuáles están listos para ser confirmados.

Las Tres Secciones de git status

Sección en Terminal Color Típico Significado y Próxima Acción
Changes to be committed Verde Archivos que ya están en el Staging Area. Si ejecutas git commit ahora mismo, estos cambios quedarán guardados en el nuevo punto de control.
Changes not staged for commit Rojo Archivos que Git ya conocía de antes (trackeados) que has modificado en tu editor, pero que aún no has preparado con git add.
Untracked files Rojo Archivos completamente nuevos que Git jamás ha visto antes. Git no los registrará a menos que los agregues expresamente con git add o los ignores en .gitignore.

El Modo Corto y Ágil: git status -s

Cuando trabajas en proyectos grandes con docenas de archivos modificados, la salida tradicional puede ser muy larga. Para obtener una vista compacta de dos columnas por archivo, usa el modificador corto:

git status -s

El primer carácter representa el estado en el Staging Area (columna izquierda) y el segundo representa el estado en tu Directorio de Trabajo (columna derecha):

  • ?? : Archivo nuevo sin seguimiento (Untracked).
  •  M : Modificado solo en el directorio de trabajo (rojo).
  • M  : Modificado y preparado en Staging (verde).
  • A  : Archivo nuevo preparado en Staging (verde).
  • D  : Archivo eliminado preparado en Staging.

⚡ Ejecución y Lectura Práctica de git status

Ejemplo de terminal creando archivos en diferentes estados y analizando la salida de git status:

inspeccionar-estado.sh
Solo lectura
# 1. Ver el estado detallado estándar:
git status

# Salida típica:
# On branch main
# Changes to be committed:
#   (use "git restore --staged <file>..." to unstage)
#         modified:   app.js
#
# Changes not staged for commit:
#   (use "git add <file>..." to update what will be committed)
#         modified:   styles.css
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#         nuevo-banner.png

# 2. Ver la versión resumida de una sola línea por archivo:
git status -s
# M  app.js
#  M styles.css
# ?? nuevo-banner.png
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Manual Completo de Git & GitHub Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de David Amador para Kilopolis Academia (Solucionáticos), estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.