Cómo comprobar si un archivo está siendo rastreado por Git

Introducción

En este laboratorio, aprenderás cómo verificar si un archivo está siendo rastreado por Git. Exploraremos dos comandos esenciales de Git: git ls-files y git status.

Primero, utilizarás git ls-files para enumerar todos los archivos actualmente rastreados por Git en tu repositorio. Luego, utilizarás git status para verificar el estado de seguimiento y comprender cómo Git informa el estado de tu directorio de trabajo cuando se han confirmado todos los cambios. Finalmente, probarás cómo Git maneja los archivos no rastreados.

Skills Graph

Ejecutar git ls-files para verificar archivos

En este paso, utilizaremos el comando git ls-files para ver qué archivos está rastreando actualmente Git en nuestro repositorio. Este comando es útil para obtener una visión general rápida de los archivos que forman parte de la historia de tu proyecto.

Primero, asegúrate de estar en el directorio my-time-machine. Si no estás, utiliza el comando cd para navegar hasta allí:

cd ~/project/my-time-machine

Ahora, ejecuta el comando git ls-files:

git ls-files

Dado que ya hemos creado y confirmado el archivo message.txt en los pasos anteriores, deberías ver el nombre de este archivo en la salida:

message.txt

El comando git ls-files enumera todos los archivos que actualmente están siendo rastreados por Git en tu repositorio. Estos son los archivos que Git está monitoreando activamente en busca de cambios y que se incluyen en tus confirmaciones (commits).

Comprender qué archivos están siendo rastreados es importante porque Git solo gestiona la historia de los archivos rastreados. Cualquier archivo que no esté siendo rastreado será ignorado por Git cuando realices confirmaciones. Esto te da control sobre lo que se incluye en la historia de versiones de tu proyecto.

En los siguientes pasos, exploraremos cómo Git maneja los archivos que aún no están siendo rastreados.

Utilizar git status para verificar el seguimiento

En el paso anterior, utilizamos git ls-files para ver que message.txt es un archivo rastreado. Ahora, usemos nuevamente el comando git status para ver cómo Git informa el estado de nuestro repositorio cuando se han confirmado todos los cambios.

Asegúrate de que todavía estés en el directorio ~/project/my-time-machine.

Ejecuta el comando git status:

git status

Deberías ver una salida similar a esta:

On branch master
nothing to commit, working tree clean

Esta salida nos dice algunas cosas importantes:

• "On branch master": Todavía estamos en la línea de tiempo principal de nuestro proyecto.
• "nothing to commit, working tree clean": Esta es la parte clave. Significa que no hay cambios en nuestro directorio de trabajo que necesiten ser confirmados. Git ve que el estado actual de los archivos coincide con el estado del último commit.

Este es el estado ideal para tu repositorio cuando has terminado un conjunto de cambios y los has confirmado. Indica que tu directorio de trabajo está "limpio" y sincronizado con el último commit.

Comparando esta salida con la salida de git status que vimos antes de crear message.txt y confirmarlo, puedes ver cómo el mensaje de estado de Git cambia para reflejar el estado de tus archivos y commits.

En el siguiente paso, introduciremos un nuevo archivo para ver cómo cambia el estado de Git cuando hay archivos no rastreados presentes.

Probar archivos no rastreados

En este paso, crearemos un nuevo archivo en nuestro directorio my-time-machine y veremos cómo cambia el estado de Git para reflejar la presencia de un archivo no rastreado.

Asegúrate de estar en el directorio ~/project/my-time-machine.

Crea un nuevo archivo llamado notes.txt utilizando el comando echo:

echo "Some random notes" > notes.txt

Este comando crea un nuevo archivo llamado notes.txt y escribe el texto "Some random notes" en él.

Ahora, veamos el estado de nuestro repositorio nuevamente utilizando git status:

git status

Deberías ver una salida similar a esta:

On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        notes.txt

nothing added to commit but untracked files present (use "git add" to track)

Observa la sección "Untracked files:". Git ha detectado el nuevo archivo notes.txt, pero nos dice que no está siendo rastreado. Esto se debe a que aún no le hemos dicho a Git que incluya este archivo en la historia de nuestro repositorio.

Este es un concepto clave en Git: debes decirle explícitamente a Git qué archivos quieres rastrear utilizando el comando git add. Esto evita que Git incluya automáticamente todos los archivos de tu directorio, lo que podría incluir archivos temporales, artefactos de compilación o notas personales que no quieres en la historia de tu proyecto.

En el siguiente laboratorio (lab), aprenderemos cómo agregar este nuevo archivo al área de preparación (staging area) y confirmarlo, convirtiéndolo en un archivo rastreado en nuestro repositorio.

Resumen

En este laboratorio (lab), aprendimos cómo verificar si un archivo está siendo rastreado por Git. Utilizamos el comando git ls-files para listar todos los archivos actualmente rastreados en el repositorio, confirmando que message.txt estaba siendo rastreado.

Luego, utilizamos el comando git status para verificar el estado del repositorio. La salida "nothing to commit, working tree clean" indicó que todos los cambios habían sido confirmados y que no había archivos no rastreados ni cambios pendientes en el directorio de trabajo. Esto reforzó nuestra comprensión de cómo Git informa el estado de los archivos rastreados.