Introducción a GIT
Tu Máquina del Tiempo para el Código: Introducción a Git e Instalación Inicial
Cuando empiezas a programar, el primer problema real no suele ser el lenguaje, sino el desorden. Archivos duplicados, versiones que se pisan, cambios que rompen lo que antes funcionaba y la sensación constante de “mejor no tocar esto”. Un Sistema de Control de Versiones (VCS) existe para eliminar exactamente ese problema.
Git es el estándar del sector para controlar versiones. No es una herramienta avanzada ni opcional: es parte del entorno básico de cualquier desarrollador web, incluso cuando trabaja solo.
Cuando juegas, no copias el juego entero cada vez que avanzas. El juego guarda un estado completo de la partida: tu posición, tu inventario, las misiones completadas y las decisiones tomadas hasta ese momento. Si derrotas a un jefe o llegas a un punto seguro, guardas la partida. Si más adelante cometes un error grave o tomas una mala decisión, cargas una partida anterior y continúas desde ahí.
¿Qué es Git?
Git es un programa que vive en tu ordenador y se encarga de:
- Registrar cambios importantes en un proyecto.
- Crear un historial claro de lo que ha pasado.
- Permitir volver atrás si algo falla.
- Dar orden y trazabilidad al trabajo.
Cada vez que decides “esto está bien así”, Git guarda ese estado. Ese guardado queda asociado a: una fecha, una persona, y un mensaje explicativo.
Basta con asumir una idea clave:
Git convierte el trabajo con código en algo reversible, controlado y profesional.
Antes de usar Git, hay que instalarlo
Git no viene siempre instalado por defecto. El primer paso es preparar tu máquina.
Instalar Git es como preparar una herramienta antes de usarla. Primero la montas, luego le dices quién la está usando, y solo después empieza el trabajo real.
Instalación de Git en Windows
En Windows, el método recomendado es el instalador oficial.
- Accede a git-scm.com.
- Descarga el instalador para Windows.
- Ejecuta el archivo
.exe.
Durante la instalación aparecerán muchas opciones. Para un principiante, lo importante es solo esto:
- Editor por defecto: selecciona uno que ya conozcas, como Visual Studio Code.
- Uso desde la línea de comandos: asegúrate de permitir usar Git desde PowerShell o la terminal del editor.
El resto de opciones se pueden dejar tal cual.
Cuando termine la instalación, busca Git Bash en el menú Inicio. Es una terminal preparada para trabajar con Git.
Para comprobar que todo está correcto, ejecuta:
git --version
Si aparece un número de versión, Git está instalado.
Instalación de Git en macOS
En macOS hay dos caminos simples:
- Descargar el instalador gráfico desde git-scm.com.
- O instalarlo mediante Homebrew, si ya lo usas.
En ambos casos, tras la instalación, abre la aplicación Terminal y ejecuta:
git --version
Ver el número de versión confirma que Git está listo.
Configuración inicial obligatoria: decirle a Git quién eres
Git necesita saber quién hace los cambios. Esto no es opcional. Sin esta información, Git no puede registrar correctamente el historial.
Debes configurar: tu nombre, tu correo electrónico. Estos datos aparecerán asociados a cada versión que guardes.
Ejemplo conceptual de configuración:
git config --global user.name "tu nombre real"
git config --global user.email "tu-email@ejemplo.com"
Nombre del autor: "Tu nombre real"
Correo del autor: "tu-email@ejemplo.com"
Una vez configurado, Git usará esa identidad en todos tus proyectos.
La idea importante no es el comando, sino el concepto:
Cada cambio en Git queda firmado. El historial siempre sabe quién hizo qué.
Qué significa “Git está listo” en este punto
Cuando Git está instalado y configurado, significa que:
- Tu ordenador puede usar Git.
- Git sabe quién eres.
- Ya puedes empezar a registrar versiones de tus proyectos.
- Todavía no necesitas trabajar en equipo ni usar plataformas externas.
Este es el punto cero correcto para un principiante.
Idea final que debe quedar clara
Git no sirve para complicarte la vida. Sirve para quitarte problemas futuros desde el principio.
- Evita perder trabajo.
- Permite aprender sin miedo a romper cosas.
- Introduce hábitos profesionales desde el primer día.
Con Git instalado y configurado, el siguiente paso lógico será aprender a usar Git dentro de un proyecto real, primero en local y después conectado a plataformas como GitHub.
Anexo · Configurar Visual Studio Code para Trabajar con Git desde el Primer Día
Este anexo explica cómo preparar Visual Studio Code para usar Git de forma natural, sin depender constantemente de la terminal y sin introducir complejidad innecesaria. El objetivo no es aprender “Git avanzado”, sino integrar Git en el flujo normal de trabajo desde el editor.
Visual Studio Code no sustituye a Git. Lo que hace es mostrar Git de forma visual, reduciendo fricción cognitiva y ayudando a entender qué está pasando en cada momento.
Requisito previo imprescindible
Antes de empezar, debe cumplirse una condición básica:
- Git ya está instalado en el sistema.
- El comando
git --versionfunciona desde la terminal.
Si Git no está instalado, Visual Studio Code no puede activar sus funciones de control de versiones.
Cómo detecta VS Code que Git está disponible
Visual Studio Code no necesita configuración manual compleja para Git.
Cuando se abre, hace lo siguiente automáticamente:
- Busca Git en el sistema.
- Si lo encuentra, activa el panel de control de versiones.
- Si no lo encuentra, desactiva todas las funciones relacionadas.
Por eso, cuando Git está bien instalado, Git “aparece solo” en VS Code.
El panel de Control de Versiones: el centro de Git en VS Code
En la barra lateral izquierda de VS Code aparece un icono con forma de: rama, o tres puntos conectados. Ese icono es el panel de Control de Versiones. Desde ahí, VS Code permite:
- Ver archivos modificados,
- Ver qué archivos están listos para guardarse como versión,
- Escribir mensajes descriptivos,
- Guardar versiones del proyecto,
- Entender visualmente qué ha cambiado.
Este panel elimina la necesidad inicial de memorizar comandos.
Abrir un proyecto correctamente para usar Git
Git funciona por carpeta, no por archivo suelto. Procedimiento correcto:
- Abrir Visual Studio Code.
- Abrir una carpeta completa (no un archivo).
- Esa carpeta será el proyecto.
Si la carpeta ya está preparada para Git, VS Code lo detecta. Si no lo está, VS Code ofrece inicializar el control de versiones.
Concepto clave:
Git siempre trabaja sobre proyectos completos, no sobre archivos aislados.
Inicializar Git desde Visual Studio Code (sin terminal)
Cuando abres una carpeta nueva sin Git:
- VS Code muestra un botón para inicializar control de versiones.
Al pulsarlo: se crea el historial local del proyecto, el proyecto queda listo para empezar a guardar versiones. No hay magia. VS Code simplemente ejecuta Git por debajo.
Ver cambios de forma visual (una ventaja didáctica)
VS Code muestra los cambios de forma inmediata:
- Archivos modificados aparecen marcados.
- Las líneas nuevas, cambiadas o eliminadas se resaltan.
- Se puede comparar el estado actual con el último guardado.
Esto es crucial para principiantes porque: conecta el cambio visual con el concepto de “versión”, evita cometer errores sin saber qué ha cambiado, refuerza la idea de control y trazabilidad.
Guardar una versión desde VS Code (concepto, no comando)
El proceso mental es el siguiente:
- Modificas archivos.
- VS Code detecta los cambios.
- Escribes un mensaje corto que explique qué hiciste.
- Guardas ese estado como una versión.
VS Code se encarga de traducir esto a Git internamente.
Idea clave:
Guardar una versión no es “terminar el proyecto”, es marcar un punto estable.
Configuración recomendada para principiantes
Para un inicio limpio y sin fricción:
- Usar la terminal integrada de VS Code (opcional, no obligatoria).
- Mantener visibles los indicadores de cambios en el editor.
- No instalar extensiones avanzadas de Git todavía.
Visual Studio Code ya incluye todo lo necesario.
Relación entre VS Code, Git y plataformas externas
En este punto:
- Git vive en tu ordenador.
- VS Code es la interfaz.
- Plataformas como GitHub todavía no son necesarias.
Primero se aprende a: guardar versiones, entender cambios, trabajar con orden. Después se conectará el proyecto con el exterior.
Error común: pensar que VS Code “es Git”
Aclaración importante:
- Visual Studio Code no es Git.
- Git es la herramienta real.
- VS Code solo la hace visible y accesible.
Si mañana cambias de editor, Git sigue funcionando igual.
Anexo · FAQ — Problemas Comunes al Instalar Git por Primera Vez en Windows
Esta sección recoge errores reales y frecuentes que aparecen en los primeros contactos con Git en Windows. No son fallos “avanzados”: son fricciones normales del entorno. Entenderlas evita bloqueos innecesarios y falsas conclusiones del tipo “Git no funciona”.
Git no se reconoce como un comando (git no existe)
- Síntoma típico: Al escribir
git --versionaparece un mensaje similar a: “gitno se reconoce como un comando interno o externo”. - Causa real: Git está instalado, pero no está en la variable PATH de Windows. El sistema no sabe dónde encontrarlo.
- Por qué ocurre: Durante la instalación no se seleccionó la opción que permite usar Git desde la línea de comandos general (PowerShell, CMD, terminal de VS Code).
- Solución conceptual: Reinstalar Git y asegurarse de permitir su uso desde la línea de comandos estándar. Git debe poder ejecutarse sin depender exclusivamente de Git Bash.
Git Bash funciona, pero PowerShell o VS Code no
- Síntoma típico: Git funciona en Git Bash, pero no en la terminal integrada de Visual Studio Code ni en PowerShell.
- Causa real: Git está instalado correctamente, pero solo está accesible desde el entorno de Git Bash.
- Por qué ocurre: Git Bash incluye su propio entorno aislado. PowerShell y VS Code dependen de que Git esté disponible en la configuración global del sistema.
- Solución conceptual: No es un fallo grave. Git funciona. Para un entorno de aprendizaje coherente, conviene reinstalar Git habilitando su uso global para que todas las terminales se comporten igual.
Git pide un editor extraño y no sabes cómo salir
- Síntoma típico: Al guardar un cambio, Git abre una pantalla confusa llena de texto y parece no responder.
- Causa real: Git está usando Vim como editor por defecto.
- Por qué ocurre: Vim es el editor histórico de Git, pero no es adecuado para principiantes si no se ha explicado previamente.
- Solución conceptual: Configurar un editor conocido, como Visual Studio Code, como editor por defecto. Git no necesita Vim para funcionar correctamente.
Error al guardar cambios: “Please tell me who you are”
- Síntoma típico: Git se niega a guardar una versión e indica que falta nombre o email.
- Causa real: La identidad del usuario no está configurada.
- Por qué ocurre: Git no configura automáticamente nombre y correo durante la instalación. Es un paso manual obligatorio.
- Solución conceptual: Configurar nombre y email una sola vez. Cada versión guardada debe estar asociada a una persona. Git lo exige por diseño.
El antivirus o Windows Defender bloquea Git
- Síntoma típico: La instalación falla, se interrumpe o Git se comporta de forma inestable.
- Causa real: El antivirus bloquea scripts o binarios durante la instalación.
- Por qué ocurre: Git incluye herramientas de línea de comandos que algunos antivirus consideran sospechosas.
- Solución conceptual: Permitir explícitamente la instalación o desactivar temporalmente el antivirus durante el proceso. Git es software seguro y ampliamente usado en entornos profesionales.
Confusión entre Git y GitHub
-
Síntoma típico: El alumno cree que Git “no funciona” porque no tiene cuenta en GitHub.
-
Causa real: Confusión conceptual.
-
Por qué ocurre: Git y GitHub suelen mencionarse juntos, pero no son lo mismo.
-
Aclaración clave:
Git es un programa que vive en tu ordenador.
GitHub es una plataforma externa para compartir proyectos.
Git funciona perfectamente sin GitHub. GitHub se introduce después.
“He instalado Git, ¿y ahora qué hago?”
- Síntoma típico: Sensación de bloqueo tras la instalación.
- Causa real: Expectativa incorrecta: se espera que Git “haga algo solo”.
- Por qué ocurre: Git es una herramienta de trabajo, no una aplicación visual que se abre y ya está.
- Solución conceptual: Git se usa dentro de proyectos, no de forma aislada. Instalarlo es preparar la herramienta. El uso real empieza cuando se trabaja con archivos.