Tabla de contenido

Instalar Git es el primer paso para entrar al mundo del control de versiones. En este tutorial te llevo desde la instalación hasta tu primer commit, paso a paso.

Instalación en Windows

  1. Ve a git-scm.com/download/win. La descarga empieza automáticamente.

  2. Ejecuta el instalador. Durante la instalación, las opciones por defecto están bien. Solo presta atención a estas pantallas:

    • “Adjusting your PATH environment”: elige “Git from the command line and also from 3rd-party software”
    • “Choosing the default editor”: puedes cambiarlo a VS Code si lo prefieres
    • “Configuring the line ending conversions”: elige “Checkout Windows-style, commit Unix-style line endings”

  3. Termina la instalación y abre Git Bash (se instala junto con Git).

Instalación en Mac

Opción 1 — Homebrew (recomendada si ya tienes Homebrew):

brew install git

Opción 2 — Xcode Command Line Tools:

xcode-select --install

Sigue las instrucciones de la ventana emergente.

Opción 3 — Instalador oficial: Descarga desde git-scm.com/download/mac.

Instalación en Linux

Ubuntu / Debian:

sudo apt update
sudo apt install git

Fedora / Red Hat:

sudo dnf install git

Arch Linux:

sudo pacman -S git

Configuración inicial obligatoria

Antes de hacer cualquier commit, debes decirle a Git quién eres. Esta información aparecerá en el historial de commits:

git config --global user.name "Tu Nombre Completo"
git config --global user.email "tu@correo.com"

Configuraciones adicionales recomendadas:

# Editor por defecto (opcional, VS Code)
git config --global core.editor "code --wait"

# Nombre de la rama principal (evita "master", usa "main")
git config --global init.defaultBranch main

# Colores en la terminal
git config --global color.ui auto

Verifica tu configuración:

git config --list

Tu primer repositorio paso a paso

Vamos a crear un proyecto de prueba desde cero:

1. Crea una carpeta para el proyecto:

mkdir mi-primer-proyecto
cd mi-primer-proyecto

2. Inicializa el repositorio:

git init

Esto crea una carpeta oculta .git donde Git guardará todo el historial.

3. Crea tu primer archivo:

echo "# Mi primer proyecto con Git" > README.md

4. Revisa el estado:

git status

Verás README.md como “untracked” (no rastreado todavía).

5. Añade el archivo al staging area:

git add README.md
# o para añadir todos los archivos:
git add .

6. Crea tu primer commit:

git commit -m "feat: agrega archivo README inicial"

7. Verifica el historial:

git log --oneline

¡Felicidades! Acabas de hacer tu primer commit.

Conectar con GitHub

Para subir tu proyecto a GitHub:

1. Crea una cuenta en github.com (si no tienes).

2. Crea un repositorio nuevo en GitHub (sin inicializar con README).

3. Conecta tu repositorio local con GitHub:

git remote add origin https://github.com/tuusuario/mi-primer-proyecto.git
git branch -M main
git push -u origin main

En el primer push te pedirá tus credenciales de GitHub.

Para subir cambios futuros:

git add .
git commit -m "descripción del cambio"
git push

Para bajar cambios del repositorio remoto:

git pull

Verificar que todo funciona

Estos comandos te ayudarán a verificar el estado de tu trabajo en todo momento:

# Ver el estado actual (archivos modificados, staged, untracked)
git status

# Ver el historial de commits
git log --oneline

# Ver qué cambió en los archivos
git diff

# Ver los repositorios remotos configurados
git remote -v

Con esto ya tienes Git instalado, configurado y funcionando. El siguiente paso es aprender el flujo de trabajo con ramas (branches), que te permitirá trabajar en nuevas funcionalidades sin afectar el código estable. Pero eso lo cubrimos en el siguiente artículo.