Skip to main content

Git en un Proyecto Real: Crear tu Primer Repositorio y Guardar Versiones

Hasta ahora has entendido qué es Git, por qué existe y por qué es una herramienta básica. Pero hay un punto clave que todavía no se ha producido: usar Git de verdad.

Git no se aprende leyendo definiciones. Se aprende cuando entra en contacto con un proyecto real, aunque ese proyecto sea pequeño y sencillo.

Git no es una aplicación que se abre. Git es algo que acompaña a un proyecto mientras trabajas en él.

Git solo tiene sentido dentro de un proyecto

Un error muy común al empezar es pensar en Git como algo separado del trabajo real.

No lo es. Git no vive en archivos sueltos. Git vive en carpetas de proyecto.

Un proyecto, para Git, es simplemente: una carpeta, con archivos dentro, y un historial de cambios asociado. Sin carpeta, no hay proyecto. Sin proyecto, Git no tiene nada que hacer.

Qué es un repositorio

La palabra repositorio suele intimidar, pero el concepto es simple.

Un repositorio es:

Una carpeta normal a la que Git le añade memoria.

Nada más. No es un formato especial. No es una base de datos externa. No es algo que cambie cómo escribes código.

Es una carpeta que ahora recuerda su historia.

El repositorio es la ranura de guardado. La carpeta es el mundo del juego.

Los archivos son el estado de la partida.

Crear un proyecto desde cero

Para aprender Git no necesitas un proyecto complejo. De hecho, cuanto más simple, mejor.

Ejemplo mental de proyecto inicial:

  • Una carpeta nueva.
  • Un solo archivo de texto.
  • Un objetivo: ver cómo Git registra cambios.

El contenido del archivo es irrelevante. Lo importante es el proceso, no el resultado.

Abrir el proyecto correctamente en Visual Studio Code

Git trabaja por carpetas completas, así que el orden importa.

Procedimiento correcto:

  1. Abres Visual Studio Code.
  2. Abres una carpeta completa.
  3. Esa carpeta se convierte en tu proyecto.

Si abres solo un archivo suelto, Git no tiene contexto.

Git necesita ver el “mundo completo del juego”, no una captura aislada.

Iniciar el control de versiones: qué significa realmente

Cuando una carpeta aún no usa Git, Visual Studio Code lo detecta.

En ese momento ocurre algo importante:

  • VS Code ofrece inicializar el control de versiones.

Inicializar Git no crea archivos nuevos tuyos. No modifica tu contenido. No sube nada a internet.

Lo único que hace es esto:

Le dice a Git:

“Empieza a recordar lo que pasa en esta carpeta”.

Desde ese instante:

  • Git observa los archivos.
  • Detecta cambios.
  • Puede guardar versiones.

Qué ocurre después de inicializar Git

Una vez Git está activo en el proyecto:

  • Los archivos pasan a tener estado.
  • Git sabe si algo ha cambiado.
  • VS Code empieza a mostrar indicadores visuales.

Esto no significa que Git haya guardado nada todavía.

Concepto clave:

Git no guarda automáticamente. Git espera a que tú decidas qué es importante.

Guardar una versión: el acto consciente más importante

Guardar una versión no es automático ni trivial. Guardar una versión significa: aceptar que el estado actual tiene sentido, decidir que merece quedar en la historia, dejar una nota explicativa para el futuro.

Ese acto se llama guardar un punto estable.

No guardas la partida cada segundo. guardas cuando has llegado a un lugar seguro.

El mensaje: por qué existe y cómo pensarlo

Cada versión guardada va acompañada de un mensaje.

Ese mensaje no es para Git. Es para ti en el futuro. Un buen mensaje responde a una pregunta simple:

¿Qué cambió desde la última vez?

No es un ensayo. No es una descripción técnica. Es una frase clara y honesta.

Ejemplos mentales:

  • “primer archivo del proyecto”
  • “texto inicial del README”
  • “corrección de errores de escritura”

El mensaje convierte el historial en algo legible.

Ver el historial: comprobar que Git ya funciona

Después de guardar varias versiones, ocurre algo importante:

  • Existe una línea temporal.
  • Puedes ver estados anteriores.
  • Puedes comprobar que el trabajo está protegido.

No hace falta explorar herramientas complejas todavía.

Basta con entender esto:

El proyecto ya tiene memoria.

Git ya está cumpliendo su función principal.

Idea final del documento

Git no te pide que programes mejor. Te pide que pienses mejor tu proceso.

  • Te obliga a decidir cuándo algo está bien.
  • Te permite equivocarte sin miedo.
  • Te da control sobre tu propio aprendizaje.

A partir de ahora, cada proyecto que crees puede tener historia. Y cuando un proyecto tiene historia, deja de ser frágil.