3. Poner el proyecto bajo control de versiones

Moverte por la terminal

Antes de inicializar nuestro primer repositorio, aclaremos cómo encuentra la terminal los archivos y directorios. Tener claras las rutas te ahorrará bastante confusión cuando empecemos a ejecutar comandos de Git.


Directorio de trabajo actual

Cada pestaña de terminal es su propia sesión de línea de comandos, y puedes tener varias sesiones paralelas abiertas una al lado de otra.

Toda sesión de terminal empieza dentro de un directorio concreto de tu ordenador. Esa ubicación se llama directorio de trabajo actual (current working directory, normalmente abreviado como cwd).

Un directorio es lo mismo que una carpeta. Cada sistema operativo usa sus propios términos, pero significan lo mismo.

Mientras trabajas en la terminal, muchos comandos operan sobre archivos y directorios relativos al directorio de trabajo actual. Naturalmente, puedes moverte a otros directorios cuando lo necesites.

La mayoría de las aplicaciones de terminal independientes empiezan por defecto en el directorio personal de tu usuario, aunque esto puede cambiarse a cualquier directorio. Las terminales integradas en editores de código suelen abrirse directamente dentro del directorio del proyecto, así que normalmente empiezas ya en el sitio correcto.

Para comprobar tu directorio actual en la terminal, puedes ejecutar el comando

. Te mostrará la ruta completa del directorio actual.

Tarea
Completada

Prueba el comando pwd en tu terminal para ver el directorio de trabajo actual.

Si quieres cambiar el directorio actual, puedes usar el comando

seguido de la ruta al directorio que quieres abrir.

Por ejemplo, si tu proyecto está en ~/projects/gitbybit, puedes ejecutar:

cd ~/projects/gitbybit

La ruta real de tu proyecto puede ser distinta, así que usa la ruta de tu propia terminal.


Trampas con espacios y mayúsculas en las rutas

Ten en cuenta que, si la ruta contiene espacios, tienes que ponerla entre comillas para que el comando cd la trate como un único argumento.

Por ejemplo, si la ruta es C:\Program Files, ejecutarías el comando cd "C:\Program Files". Puedes usar comillas simples ' o dobles ", pero usa siempre el mismo par de comillas.

Por ejemplo, si la ruta es /home/alex/my documents, ejecutarías el comando cd "/home/alex/my documents". Puedes usar comillas simples ' o dobles ", pero usa siempre el mismo par de comillas.

Además, ten en cuenta que en la mayoría de sistemas operativos (Linux y macOS incluidos), las rutas y los comandos distinguen entre mayúsculas y minúsculas. Por ejemplo, /home/Alex y /home/alex son dos rutas distintas.


Rutas absolutas

Por ejemplo, /home/alex/gitbybit-part1C:\Users\Alex\gitbybit-part1 es una ruta absoluta, una ruta que empieza en el directorio raíz del sistema de archivos. Estas rutas son superespecíficas y siempre apuntan a la misma ubicación en tu ordenador, da igual cuál sea tu directorio de trabajo actual. Eso sí: son específicas de TU ordenador, así que no son tan útiles en instrucciones pensadas para otras personas.

Las rutas absolutas siempre empiezan con una letra de unidad (C: en Windows) o con una barra (/, que representa la raíz del sistema de archivos en Linux y macOS).


Rutas relativas

También existen las rutas relativas, que son relativas a un directorio de trabajo actual. Son más flexibles y portables. Por ejemplo, file.txt o ./file.txt se refiere a un archivo del directorio actual, y ../notes/todo.md apunta a un archivo dentro de la carpeta notes, un nivel por encima.

Las rutas relativas empiezan desde las carpetas del proyecto, no desde la raíz de todo el sistema de archivos. Un comando que usa una ruta relativa funcionará en cualquier ordenador, siempre que todo el mundo tenga el proyecto organizado de la misma forma. Son ideales para proyectos compartidos, control de versiones y documentación que otras personas puedan seguir sin cambiar rutas.

Hay atajos especiales como . (directorio actual) y .. (directorio padre). Así que, para ir al directorio padre, puedes usar el comando cd ... Este comando te sube un nivel en el árbol de directorios.

A veces verás rutas como esta: ./example. Significa lo mismo que example (el directorio actual está implícito). Por tanto, el comando cd ./example equivale a cd example.

Puedes combinar estos atajos con nombres de directorio para moverte a un directorio concreto. Por ejemplo, para ir al directorio example que está dos niveles por encima de tu proyecto, ejecutarías el comando cd ../../example.

Muchas herramientas de línea de comandos aceptan rutas como argumentos, así que este conocimiento te servirá para algo más que el comando cd.

CONSEJO MUY ÚTIL: Puedes usar la tecla Tab del teclado para autocompletar nombres de archivos y directorios en la terminal. Por ejemplo, si tienes un subdirectorio src, puedes escribir cd s y luego pulsar Tab para autocompletar el comando como cd src (o como cd ./src en algunos sistemas, que es lo mismo). Es una forma estupenda de evitar erratas y trabajar más rápido.

Autocompletado con Tab en la Terminal.
Genial, viene bien saberlo

Acabas de aprender cómo funcionan las rutas y el directorio de trabajo actual, así que vamos a ponerlo a prueba.

En este punto, tu terminal debería estar en el directorio raíz del proyecto. Es justo donde queremos crear nuestro repositorio. Pero nunca está de más comprobar que estás en el sitio correcto. Porque a veces...

Vamos a interpretar un papel. Imagina que eres un gato intentando ayudar a tu persona favorita mientras se ha ido a por café. Tú, el gato, solo has conseguido ejecutar un comando: cd ~ (hazlo ahora). Esto cambiará tu directorio actual, pero en un momento veremos cómo volver al directorio del proyecto.

Tarea
Completada

Ahora, usando los comandos que hemos aprendido hasta ahora, lleva la terminal de vuelta al directorio raíz del proyecto.

Consejo n.º 1: Si no recuerdas cuál era el directorio del proyecto, desplázate hacia arriba en la terminal hasta encontrar la salida del comando pwd que ejecutaste antes.

Consejo n.º 2: Si no tienes claro qué hacer, abre una terminal nueva en el directorio del proyecto (aunque eso cuenta como hacer trampas).

Genial, parece que entiendes bien las rutas y el directorio de trabajo actual. Usemos esto para inicializar nuestro repositorio.

Next step
¿Quieres probar el modo historia?

Haz el curso como estaba pensado: progreso en pequeñas dosis, un orden lineal y sin distracciones, y entradas de Gitopedia que se desbloquean poco a poco. Continúa con Git real en VS Code/Cursor/Antigravity/Windsurf cuando quieras.

Modo historia
GRATIS
pero requiere iniciar sesión