Git y Github

¿Qué es Git?

Git fue creado en 2005 por Linus Torvalds (el creador de Linux). Es el sistema de control de versiones más usado del mundo.

Distribuido vs Centralizado

Git es distribuido: cada desarrollador tiene el historial completo en su máquina. Sistemas antiguos como SVN o CVS eran centralizados: si el servidor se caía, nadie podía trabajar.

Sin Git vs Con Git

Las tres áreas de Git

Git organiza tu trabajo en tres áreas. Los archivos fluyen de izquierda a derecha.

git add archivo.txt

  Directorio → Staging Area

git commit -m "Descripción"

  Staging Area → Repositorio

Anatomía de un Commit

Cada commit es una "foto" del estado del proyecto en un momento dado, con un mensaje descriptivo.

commit a1b2c3d

Author: Ana García <ana@email.com>

Date:   Mon Apr 7 10:30:00 2026

    Agrega formulario de contacto

"Agrega formulario de contacto"     ← Último

"Implementa menú de navegación"

"Primera versión del sitio"          ← Primero

HEAD: el puntero que te sitúa

HEAD es un puntero especial que indica en qué commit estás ahora mismo. Normalmente apunta al último commit de tu rama actual. Cuando haces checkout, HEAD se mueve.

git diff HEAD~1

  # diff con commit anterior

git reset --soft HEAD~1

  # deshacer último commit

git checkout HEAD~3

  # viajar 3 commits atrás

Ramas y Merge

Una rama es un puntero a un commit del árbol. Crear una rama no copia archivos: solo añade otro puntero al mismo nodo. Merge une dos ramas creando un commit con dos padres.

Inicializar y configurar

git config --global user.name "Tu Nombre"

git config --global user.email "tu@email.com"

# Crear nuevo repositorio

git init

# Clonar uno existente

git clone https://github.com/user/repo.git

El flujo básico

Estos 4 comandos son el pan de cada día de todo desarrollador.

git status

  # Ver estado de archivos

git add archivo.txt

  # Agregar un archivo al staging

git add .

  # Agregar todo

git commit -m "Descripción del cambio"

  # Crear commit

git push

  # Subir a Github

Ver historial y diferencias

git log

  # Historial completo

git log --oneline

  # Historial compacto

git diff archivo.txt

  # Ver cambios sin commitear

# Archivo .gitignore

node_modules/

.env

*.exe

.DS_Store

Trabajar con ramas

git branch

  # Ver ramas

git checkout -b mi-rama

  # Crear y cambiar a rama

git checkout main

  # Volver a main

git merge mi-rama

  # Fusionar rama en la actual

git branch -d mi-rama

  # Eliminar rama fusionada

git pull

  # Descargar cambios remotos

Buenos mensajes de commit

Un buen mensaje le ahorra horas a tu yo del futuro. El estándar más usado es Conventional Commits.

tipo(ámbito): descripción

# Ejemplos

feat(auth): agrega login con Google

fix(api): corrige timeout en /users

docs: actualiza README

refactor: extrae lógica a helper

Deshacer cambios sin miedo

Git te permite volver atrás. Cada comando tiene un alcance distinto: elige según dónde esté el cambio que quieres deshacer.

git restore archivo.txt

  # vuelve a la última versión commiteada

git stash

git checkout main

git stash pop

git reset --soft HEAD~1

  # deshacer último commit, conservar cambios

git reset --hard HEAD~1

  # destructivo: borra los cambios

git revert a1b2c3d

  # historial intacto, cambios revertidos

Crear y conectar un repositorio

# Conectar con Github

git remote add origin \

  https://github.com/tu-user/tu-repo.git

# Renombrar rama a main

git branch -M main

# Subir por primera vez

git push -u origin main

Fork vs Clone y tu portafolio

SSH keys: autenticación segura

Github ya no acepta contraseñas por HTTPS para push. Tienes dos opciones modernas: SSH keys (recomendado) o Personal Access Tokens.

ssh-keygen -t ed25519 -C "tu@email.com"

  # Enter para aceptar ubicación

  # Pon una passphrase (opcional)

# Copia la llave pública

cat ~/.ssh/id_ed25519.pub

# Ahora puedes clonar con SSH

git clone git@github.com:usuario/repo.git

  # ¡sin contraseña cada push!

Más allá del código

Github no es solo almacenamiento. Es una plataforma completa de gestión de producto y automatización.

# .github/workflows/tests.yml

on: [push, pull_request]

jobs:

  test:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v4

      - run: npm ci && npm test

Cada vez que alguien haga git push o abra un PR, Github ejecutará tus tests automáticamente.

Github Flow

El flujo de trabajo más simple y popular para equipos.

# 1. Crear rama

git checkout -b feature/agregar-login

# 2. Hacer cambios y commits

git add .

git commit -m "Implementa formulario de login"

# 3. Subir la rama

git push -u origin feature/agregar-login

# 4. Crear PR en Github → revisión → merge

main siempre desplegable. La rama feature evoluciona, se abre un PR, y al hacer merge se crea un commit con dos padres en main.

Conflictos de merge

Un conflicto ocurre cuando dos ramas modifican la misma línea de un mismo archivo. Git no sabe cuál es la versión correcta y te pide que decidas.

git merge feature

CONFLICT (content): Merge conflict in app.js

Automatic merge failed; fix conflicts and commit.

function saludo() {

<<<<<<< HEAD

  return "Hola";

=======

  return "Hello";

>>>>>>> feature

}

Workflows: elige el adecuado

No hay un único “Git correcto”. Cada equipo adopta un flujo de trabajo según su tamaño, producto y frecuencia de release.

Buenas prácticas en PRs

Ejercicio 3.2: Práctica de commits

Practica el flujo de trabajo básico: crear archivos, modificarlos, ver diferencias y hacer commits.

# 1. Crear un archivo

echo "Mis notas del curso" > notas.txt

git add notas.txt

git commit -m "Agrega notas del curso"

# 2. Modificar el archivo

echo "Clase 3: Git y Github" >> notas.txt

# 3. Ver los cambios

git diff notas.txt

# 4. Commit y verificar

git add notas.txt

git commit -m "Agrega notas de clase 3"

git log --oneline

Ejercicio 3.3: Trabajando con ramas

Crea una rama, haz cambios, y luego fusiona. Observa cómo los archivos aparecen y desaparecen al cambiar de rama.

# 1. Crear y cambiar a nueva rama

git checkout -b feature/nuevo-contenido

# 2. Crear archivo y hacer commit

echo "Contenido nuevo" > contenido.txt

git add contenido.txt

git commit -m "Agrega contenido.txt"

# 3. Volver a main — ¡el archivo desaparece!

git checkout main

ls    # contenido.txt NO aparece

# 4. Merge — ¡ahora sí aparece!

git merge feature/nuevo-contenido

ls    # contenido.txt SÍ aparece

git branch -d feature/nuevo-contenido

Ejercicio 3.4: Subir a Github

Conecta tu repositorio local con Github y sube tu código a la nube.

git remote add origin URL

git branch -M main

git push -u origin main

# Hacer un cambio y verificar

echo "update" >> README.md

git add . && git commit -m "update"

git push

Ejercicio 3.5: Simular un Pull Request

Simula el flujo completo de trabajo en equipo: rama, cambios, push y Pull Request.

# 1. Crear rama

git checkout -b feature/mi-cambio

# 2. Hacer cambios significativos

echo "Nueva sección" > seccion.md

git add . && git commit -m "Agrega sección"

# 3. Push de la rama

git push -u origin feature/mi-cambio

# 4. En Github: crear PR con descripción

# 5. Revisar en "Files changed"

# 6. Mergear el PR desde Github

# 7. Actualizar local

git checkout main

git pull

Ejercicio 3.7: Resuelve un conflicto de merge

Un conflicto real. Elige cómo resolverlo y ve las consecuencias de cada decisión.

export function Header() {

  return (

<<<<<<< HEAD

    <h1>Mi Portafolio</h1>

=======

    <h1>Ana García — Dev</h1>

>>>>>>> feature/header

  )

}

git add Header.tsx

git commit -m "resuelve conflicto en Header.tsx"

Estructura sugerida del README

# Tu Nombre

Breve descripción sobre ti.

## Sobre mí

- Estudiante de desarrollo de software

- Interesado en: web, IA, mobile...

## Proyectos

| Proyecto | Descripción | Tecnologías |

|----------|-------------|-------------|

| Mi App   | App de notas| TypeScript  |

## Contacto

- Email: tu@email.com

- LinkedIn: linkedin.com/in/tu-perfil

Bonus y criterios