En la lección anterior vimos por qué existe Git y conocimos a Ana, Bruno y Carla, el equipo que va a construir gestor-tareas. Antes de que Ana pueda convertir su carpeta en un repositorio necesita algo elemental: tener Git instalado. Esta lección cubre la instalación en los tres sistemas operativos habituales —Linux, macOS y Windows—, cómo verificar que ha ido bien, cómo consultar la ayuda incorporada y cómo mantener Git actualizado. También aclararemos qué es Git Bash, qué son los clientes gráficos y por qué durante todo el curso trabajaremos con la línea de comandos.

Es una lección eminentemente práctica: al terminarla tendrás un Git funcional en tu equipo y sabrás comprobarlo.

1. Antes de empezar: comprobar si ya tienes Git
2. Instalación en Linux
3. Instalación en macOS
4. Instalación en Windows
5. Verificar la instalación
6. La ayuda incorporada: git help
7. Git Bash, terminales y clientes gráficos
8. Por qué la línea de comandos en este curso
9. Cómo actualizar Git

Muchos sistemas traen Git preinstalado o lo han instalado otras herramientas. Antes de descargar nada, abre una terminal y ejecuta:

Hay dos resultados posibles:

Si ves algo así, ya tienes Git. Comprueba que la versión sea razonablemente reciente (2.30 o superior es suficiente para todo el curso; 2.40 o superior es lo ideal) y salta al apartado 5.

Si ves esto —o 'git' is not recognized... en Windows—, Git no está instalado o no está en el PATH. Sigue el apartado que corresponda a tu sistema.

Nota sobre versiones. Git es extraordinariamente estable y compatible hacia atrás: casi todo lo que aprendas funcionará igual dentro de diez años. Aun así, algunas comodidades modernas (como git switch o git restore, que veremos en los módulos 2 y 3) requieren Git 2.23 o superior, y ciertos valores por defecto sensatos llegaron en la 2.28. Vale la pena no quedarse en una versión antigua.

En Linux, Git se instala desde el gestor de paquetes de la distribución. Es la vía recomendada: el sistema se encarga de las dependencias y de las actualizaciones.

Desglose de los comandos:

• sudo ejecuta el comando con privilegios de administrador, necesarios para instalar software en todo el sistema. Pedirá tu contraseña.
• apt update refresca la lista de paquetes disponibles y sus versiones. No actualiza ningún programa; solo pone al día el catálogo. Omitir este paso es la causa más frecuente de que se instale una versión antigua.
• apt install git descarga e instala el paquete git y sus dependencias.

En sistemas antiguos con yum en lugar de dnf, el comando equivalente es sudo yum install git.

El paquete git básico incluye todo lo esencial, pero algunas distribuciones separan extras que conviene tener:

• gitk es un visor gráfico del historial que viene con Git.
• git-gui es un cliente gráfico mínimo para preparar y confirmar cambios.
• git-email habilita el envío de parches por correo, usado en proyectos como el kernel de Linux.

Ninguno es imprescindible para el curso.

Las distribuciones estables suelen ir algo por detrás. Si necesitas la versión más reciente, existe un repositorio oficial mantenido por el equipo de Git:

add-apt-repository añade una fuente de paquetes adicional; a partir de ahí, apt la tratará como cualquier otra y ofrecerá actualizaciones automáticas de Git.

En macOS hay tres caminos. El orden en que los presentamos es también el orden de preferencia.

Homebrew es el gestor de paquetes de facto en macOS. Si aún no lo tienes:

Este comando descarga el script oficial de instalación y lo ejecuta. Desglose: curl descarga la URL (-fsSL significa "falla en errores, modo silencioso, muestra errores, sigue redirecciones") y $( ) pasa el resultado a bash para que lo ejecute.

Con Homebrew ya disponible:

Homebrew instala Git en /opt/homebrew/bin/git (Apple Silicon) o /usr/local/bin/git (Intel), rutas que tienen prioridad sobre la versión del sistema en el PATH. Así siempre tendrás una versión actualizada.

macOS incluye una versión de Git dentro de las herramientas de desarrollo de Apple. Se instalan con:

Aparecerá una ventana del sistema pidiendo confirmación. También se disparan automáticamente la primera vez que escribes git en una terminal sin tenerlas instaladas.

Ventaja: no requiere nada más. Inconveniente: la versión suele ir varios meses o años por detrás, y solo se actualiza con las actualizaciones del sistema.

Existen instaladores .dmg en git-scm.com/download/mac. Es una opción válida si no quieres gestores de paquetes, pero la actualización queda en tus manos.

Windows no incluye Git, así que hay que instalarlo. Hay tres vías.

Descarga el instalador desde git-scm.com/download/win y ejecútalo. El asistente hace bastantes preguntas; estas son las que importan y las respuestas recomendadas:

Si dudas en alguna pantalla no marcada aquí, deja el valor por defecto: son elecciones sensatas y casi todas se pueden cambiar después con git config.

Si prefieres una instalación desatendida:

O con Chocolatey:

winget viene incluido en Windows 10 y 11 modernos. El parámetro -e fuerza coincidencia exacta del identificador para no instalar un paquete parecido por error.

WSL ejecuta una distribución Linux real dentro de Windows. Si desarrollas con herramientas del mundo Unix (Node.js, Python, Docker), suele ser la mejor experiencia.

Una vez dentro de la distribución (Ubuntu por defecto), Git se instala como en cualquier Linux:

Advertencia importante con WSL. El Git de Windows y el Git de WSL son dos instalaciones distintas, con configuraciones independientes. Además, trabajar desde WSL sobre ficheros almacenados en el disco de Windows (/mnt/c/...) es notablemente lento y provoca problemas con los permisos y los finales de línea. La recomendación es guardar los repositorios dentro del sistema de ficheros de Linux (~/proyectos/...) y usar solo el Git de WSL.

Independientemente del sistema, cierra y vuelve a abrir la terminal (para que recoja los cambios en el PATH) y ejecuta:

Salida esperada, con el número que corresponda:

Comprobaciones adicionales útiles:

El último comando imprime una lista larga. No hace falta entenderla; sirve para confirmar que la instalación está completa y no truncada.

Git trae su documentación completa dentro del propio programa. Aprender a consultarla es más valioso que memorizar opciones.

Este comando abre la página de manual de git config. En Linux y macOS se muestra con el paginador less: se navega con las flechas o espacio, se busca con /palabra y se sale con q. En Windows, git help abre por defecto la versión HTML en el navegador.

Existen tres formas equivalentes de pedir el manual de un comando:

Para una consulta rápida, sin abrir el manual completo, existe el resumen de opciones:

La -h minúscula imprime unas pocas líneas con la sintaxis y las opciones principales directamente en la terminal. Es la opción que más usarás en el día a día.

Prueba git help -g: Git incluye guías temáticas como gittutorial, giteveryday o gitglossary, que se leen con git help giteveryday.

Git Bash es un componente exclusivo de Windows que viene con el instalador oficial. No es Git: es un emulador de terminal que trae consigo un intérprete Bash y un conjunto de utilidades Unix (ls, grep, ssh, curl, vim…) compiladas para Windows.

Existe por una razón práctica: la documentación de Git, los ejemplos de internet y los hooks (scripts que se ejecutan automáticamente, módulo 6) asumen un entorno Unix. Git Bash proporciona ese entorno sin salir de Windows.

Si estás en Windows, usa Git Bash para seguir el curso: los comandos de las lecciones funcionarán tal cual están escritos. En Linux y macOS, la terminal del sistema ya es suficiente.

Un cliente gráfico (GUI) es una aplicación con ventanas y botones que ejecuta comandos de Git por debajo. Los más conocidos:

Los clientes gráficos son útiles, sobre todo para revisar diferencias y navegar el historial. No hay nada malo en usarlos, y muchos profesionales combinan terminal para operar y GUI para inspeccionar.

Este curso usa exclusivamente la línea de comandos, por razones concretas:

1. Es la única interfaz completa. Todos los clientes gráficos implementan un subconjunto de Git. Tarde o temprano necesitarás algo que tu GUI no ofrece, y entonces habrá que abrir la terminal igualmente.
2. Es universal. Un servidor de integración continua, una máquina remota por SSH o el portátil de un compañero no tienen tu GUI instalada, pero todos tienen git en la terminal.
3. Enseña el modelo, no la herramienta. Los botones esconden lo que ocurre. Escribir git commit después de git add obliga a entender que existen dos pasos, y ese entendimiento es lo que hace que puedas resolver problemas.
4. La documentación y las respuestas están en comandos. Cualquier manual, incidencia o respuesta que encuentres estará expresada en comandos, no en "haz clic aquí".
5. Es más rápida una vez aprendida. Y se automatiza: los comandos se encadenan en scripts, los gráficos no.

Consejo práctico. Aprende primero en la terminal y añade después el cliente gráfico que te apetezca. El orden inverso deja lagunas difíciles de cerrar.

Mantener Git al día aporta correcciones de seguridad, mejoras de rendimiento y comandos nuevos. Los comandos de actualización según el sistema:

En Windows, además, las versiones modernas de Git incorporan un comando propio de actualización:

Este comando comprueba si hay una versión más reciente de Git for Windows, la descarga y lanza el instalador. Solo existe en Windows.

Para comprobar qué versión es la última publicada, consulta git-scm.com o ejecuta el comando de actualización de tu gestor de paquetes: si no hay nada nuevo, te lo dirá.

Actualizar no rompe nada. Los repositorios existentes siguen funcionando igual tras actualizar: el formato en disco es compatible hacia atrás desde hace más de una década. Actualizar es seguro.

• No cerrar la terminal después de instalar. El PATH se lee al abrir la sesión de la terminal. Si acabas de instalar Git y git --version falla, ciérrala y ábrela de nuevo antes de dar nada por perdido.
• Olvidar apt update antes de apt install. Sin refrescar el catálogo puedes acabar instalando una versión muy antigua o recibir un error de paquete no encontrado.
• En Windows, no marcar la opción del PATH. Si eliges "Use Git from Git Bash only", git no funcionará en PowerShell ni en VS Code. Se arregla reejecutando el instalador.
• Mezclar el Git de Windows y el de WSL sobre la misma carpeta. Provoca conflictos de permisos, finales de línea distintos y configuraciones cruzadas. Elige uno y guarda los repositorios en su sistema de ficheros nativo.
• Instalar Git desde un .zip descomprimido a mano. Funciona, pero no queda registrado en el sistema y las actualizaciones se vuelven un problema. Usa siempre el gestor de paquetes o el instalador oficial.
• Consejo: fija tu editor durante la instalación en Windows. Si dejas el valor por defecto acabarás en Vim la primera vez que Git te pida escribir un mensaje. Se puede cambiar después (lección 01-06), pero es una sorpresa desagradable.
• Consejo: instala también gitk en Linux. Es un visor del historial muy útil para entender lo que estás aprendiendo, y no interfiere con el uso de la terminal.

Ejecuta los comandos necesarios para responder a estas cinco preguntas sobre tu equipo, y anota tanto el comando usado como el resultado:

1. ¿Qué versión de Git tienes instalada?
2. ¿En qué ruta está el ejecutable?
3. ¿Hay más de una instalación de Git en tu PATH?
4. ¿Cuántos subcomandos ofrece tu instalación?
5. ¿Qué guías conceptuales incluye la documentación?

Sin buscar en internet, usa exclusivamente la ayuda incorporada de Git para averiguar:

1. Qué hace la opción --global del comando git config.
2. Qué comando de Git sirve para "mostrar el estado del directorio de trabajo" (búscalo en la lista de comandos habituales).
3. El nombre de la guía incluida que resume el uso diario de Git.

Indica en cada caso qué comando ejecutaste.

El equipo de gestor-tareas es heterogéneo: Ana trabaja en Ubuntu, Bruno en un MacBook con Apple Silicon y Carla en Windows 11. Redacta unas instrucciones breves para cada uno con: (a) el comando o método de instalación, (b) cómo verificar que ha funcionado y (c) una advertencia específica de su plataforma.

Solución al Ejercicio 1

Solución al Ejercicio 2

1. --global en git config:

La documentación indica que --global escribe en el fichero de configuración del usuario (~/.gitconfig), aplicable a todos los repositorios de ese usuario. Es el nivel que usaremos en la lección 01-05.

2. Comando de estado:

En la sección de comandos habituales aparece status con la descripción "Show the working tree status". El comando es git status y lo usaremos operativamente en el módulo 2.

3. Guía de uso diario:

La guía es giteveryday, que se lee con git help giteveryday. Resume los veinte comandos que cubren el 95 % del uso real.

Solución al Ejercicio 3

Ana — Ubuntu

Advertencia: la versión de los repositorios oficiales de Ubuntu puede ir varias versiones por detrás. Si necesita lo último, debe añadir el PPA ppa:git-core/ppa antes de instalar.

Bruno — macOS (Apple Silicon)

Advertencia: macOS trae su propio Git en /usr/bin/git a través de las Command Line Tools. Si which git devuelve esa ruta en lugar de la de Homebrew, el PATH está mal ordenado y seguirá usando la versión antigua.

Carla — Windows 11

Descargar el instalador de git-scm.com/download/win y, durante el asistente, elegir "Git from the command line and also from 3rd-party software" en la pantalla del PATH, main como nombre de rama inicial y su editor habitual.

Advertencia: si no marca la opción del PATH, git funcionará solo dentro de Git Bash y fallará en PowerShell y en su editor. Además, debe seguir el curso desde Git Bash para que los comandos de las lecciones funcionen literalmente.

Ya tienes Git instalado y verificado. Hemos visto que en Linux se instala con el gestor de paquetes de la distribución, en macOS lo más práctico es Homebrew (con las Command Line Tools como alternativa sin requisitos) y en Windows el instalador oficial de Git for Windows, que además aporta Git Bash, el entorno de terminal con el que conviene seguir el curso. La comprobación básica es siempre la misma —git --version— y la documentación completa vive dentro del propio programa, accesible con git help <comando> o, para consultas rápidas, git <comando> -h.

También hemos justificado la decisión metodológica del curso: trabajaremos en la línea de comandos porque es la interfaz completa, universal y la que enseña el modelo de Git en lugar de esconderlo. Los clientes gráficos son un complemento excelente, no un sustituto.

Tener la herramienta no basta: hay que entender su vocabulario. En la siguiente lección, Terminología Básica de Git, construiremos el glosario que sostiene todo lo demás —repositorio, área de preparación, confirmación, HEAD, rama, remoto— y veremos el diagrama de los tres estados por los que pasa cualquier fichero en Git.