Saltar a contenido

Guía paso a paso: trabajo con ramas en Git

Preparación inicial (una sola vez en cada ordenador)

# Clonar el repositorio remoto en este ordenador
git clone <URL_DEL_REPOSITORIO_REMOTO>

Con este comando descargas el proyecto por primera vez y creas una copia local conectada al remoto.

# Entrar en la carpeta del proyecto
cd <NOMBRE_DEL_PROYECTO>

A partir de aquí ya estás dentro del repositorio local y puedes ejecutar comandos de Git.

# Verificar el remoto configurado
git remote -v

Así compruebas a qué URL está enlazado el repo para fetch y push.

# Asegurar que la rama principal local se llama main
git branch -M main

Este paso unifica el nombre de la rama principal en main.

Empezar una nueva funcionalidad (en cualquier ordenador)

# Traer la información más reciente del remoto (sin mezclarla aún)
git fetch origin

Actualizas tus referencias locales de ramas y commits remotos.

# Cambiar a main
git switch main

Te sitúas en la rama principal local.

# Actualizar tu main local con lo último del remoto
git pull origin main

Aquí descargas e integras en main los cambios más recientes del remoto.

# Crear y cambiar a una nueva rama para la funcionalidad
git switch -c feature-login

De esta forma empiezas a trabajar aislado del resto del equipo.

Hacer cambios y guardarlos como commits

# Ver qué archivos cambiaste
git status

Muestra cambios pendientes, archivos en staging y la rama actual.

# Añadir archivos al área de preparación (staging)
git add .

Seleccionas qué cambios entrarán en el siguiente commit.

# Crear un commit con un mensaje
git commit -m "Añade formulario de login"

Queda registrado un punto de control con tus cambios versionados.

Subir tu rama al remoto (para sincronizar entre ordenadores)

# Subir la rama al remoto por primera vez y crear el vínculo de seguimiento
git push -u origin feature-login

Con -u Git deja asociada tu rama local con su equivalente remota.

Continuar el trabajo desde otro ordenador (misma rama)

# Entrar en la carpeta del repo ya clonada en ese ordenador
cd <NOMBRE_DEL_PROYECTO>

Primero accede al repositorio local.

# Traer referencias actualizadas del remoto
git fetch origin

Así ves ramas nuevas y commits subidos desde otros equipos.

# Cambiar a la rama de la funcionalidad
# (si no existe localmente, Git puede crearla siguiendo el remoto)
git switch feature-login

Te colocas en la rama en la que continuarás trabajando.

# Traer los commits más recientes de esa rama
git pull

Sincronizas la rama local con su rama remota asociada.

# Hacer cambios, preparar y commitear
git status
git add .
git commit -m "Valida credenciales en backend"

Ese bloque cubre el ciclo habitual: revisar, preparar y guardar cambios.

# Subir los nuevos commits al remoto
git push

Publicas tus avances para que estén disponibles en el servidor remoto.

Mantener tu rama de funcionalidad al día con main

# Traer lo último del remoto
git fetch origin

Refrescas la información remota sin modificar todavía tu rama activa.

# Actualizar main local
git switch main
git pull origin main

Con esto dejas main local alineada con origin/main.

# Volver a la rama de funcionalidad
git switch feature-login

Regresas a tu rama de trabajo.

# Mezclar main dentro de tu rama de funcionalidad
git merge main

Incorporas los cambios recientes de main en tu rama.

# Si hubo conflictos, después de resolverlos en los archivos
git add .
git commit -m "Resuelve conflictos al mezclar main"

Este paso marca los conflictos como resueltos y cierra la integración.

# Subir la rama actualizada al remoto
git push

Así compartes la rama ya sincronizada con main.

Integrar la funcionalidad en main (cuando esté lista)

# Actualizar main antes de integrar
git switch main
git pull origin main

Evitas integrar sobre una base desactualizada.

# Mezclar la rama de funcionalidad en main
git merge feature-login

Aquí incorporas en main todos los commits de la funcionalidad.

# Subir main actualizada al remoto
git push origin main

El resultado final queda publicado en la rama principal remota.

Limpiar la rama de funcionalidad cuando ya está integrada

# Borrar la rama local (solo si ya está integrada)
git branch -d feature-login

Mantienes el repositorio local limpio y evitas ramas obsoletas.

# Borrar la rama remota
git push origin --delete feature-login

También limpias el remoto cuando esa rama ya no hace falta.

Sincronización diaria mínima al empezar (en cualquier ordenador)

git switch main
git pull origin main

Es la rutina más corta para comenzar con una base actualizada antes de crear ramas nuevas o integrar trabajo.