Ramas

Crear, cambiar y fusionar ramas de desarrollo

El desarrollo con ramas permite trabajar en funcionalidades independientes sin afectar el código principal. Visual Studio Code proporciona herramientas integradas que simplifican estas operaciones fundamentales del flujo de trabajo con Git.

Crear una nueva rama

La forma más directa de crear una rama es utilizando el selector de ramas en la barra de estado. Este elemento muestra el nombre de la rama actual y permite crear nuevas ramas con un solo clic.

1 - Acceso desde la barra de estado:

main ↓ (en la esquina inferior izquierda)

Al hacer clic en el nombre de la rama actual, se abre el Command Palette con opciones específicas para ramas. Selecciona "Create new branch" para iniciar el proceso.

2 - Nomenclatura de ramas:

feature/nueva-funcionalidad
bugfix/correccion-login
hotfix/error-critico

Visual Studio Code sugiere automáticamente crear la rama desde la rama actual. Es recomendable estar en main antes de crear ramas de funcionalidad para mantener un historial limpio.

3 - Creación automática:

Una vez introducido el nombre, VS Code:

• Crea la nueva rama
• Cambia automáticamente a ella
• Actualiza el indicador en la barra de estado

Cambiar entre ramas

El cambio de ramas se realiza mediante el mismo selector de la barra de estado. Esta operación es segura siempre que no existan cambios sin confirmar.

1 - Selector visual:

feature/nueva-funcionalidad ↓

Al hacer clic, aparece una lista con todas las ramas locales disponibles. Las ramas remotas se muestran en una sección separada si existen.

2 - Cambio seguro:

VS Code verifica automáticamente si existen cambios sin confirmar antes de permitir el cambio. Si los hay, ofrece opciones para:

• Confirmar los cambios primero
• Descartar los cambios
• Cancelar la operación

3 - Indicadores visuales:

La barra de estado siempre refleja la rama activa. Además, el panel Source Control muestra información específica de la rama actual, incluyendo commits pendientes de sincronización.

Fusionar ramas

La fusión de ramas en VS Code se gestiona desde el panel Source Control, proporcionando una interfaz visual para esta operación crítica.

1 - Preparación para merge:

Antes de fusionar, es fundamental:

• Cambiar a la rama de destino (normalmente main)
• Asegurar que está actualizada con el repositorio remoto
• Verificar que no hay cambios pendientes

2 - Proceso de fusión:

Desde el panel Source Control, accede al menú de opciones (tres puntos) y selecciona "Branch" → "Merge Branch". VS Code presenta una lista de ramas disponibles para fusionar.

Seleccionar rama: feature/nueva-funcionalidad
↓
Confirmar fusión
↓
Actualización automática del historial

3 - Tipos de fusión:

VS Code maneja automáticamente dos tipos de fusión:

• Fast-forward: Cuando no hay commits adicionales en la rama principal
• Merge commit: Cuando ambas ramas han evolucionado independientemente

El editor muestra claramente qué tipo de fusión se realizará antes de confirmar la operación.

Eliminar ramas fusionadas

Una vez completada la fusión, las ramas de funcionalidad deben eliminarse para mantener un repositorio limpio. VS Code facilita esta tarea de mantenimiento.

1 - Eliminación local:

Desde el selector de ramas, las ramas fusionadas aparecen marcadas visualmente. Al seleccionar una rama fusionada, VS Code ofrece la opción "Delete Branch" en el menú contextual.

2 - Verificación de seguridad:

El editor verifica que la rama ha sido fusionada antes de permitir su eliminación. Esta protección evita la pérdida accidental de trabajo no integrado.

3 - Limpieza de ramas remotas:

Para ramas que también existen en el repositorio remoto, VS Code ofrece eliminar tanto la versión local como la remota en una sola operación, manteniendo sincronizado el proyecto.

Visualización del historial de ramas

El Git Graph integrado en VS Code proporciona una representación visual del historial de ramas, facilitando la comprensión del flujo de desarrollo.

1 - Acceso al historial:

Desde el panel Source Control, el icono de historial (reloj) abre una vista cronológica de commits que incluye información sobre ramas y fusiones.

2 - Información contextual:

Cada commit muestra:

• Rama de origen
• Autor y fecha
• Mensaje descriptivo
• Relaciones de fusión

Esta visualización ayuda a entender el flujo de trabajo y verificar que las fusiones se han realizado correctamente.

Flujo de trabajo recomendado

Un workflow eficiente con ramas en VS Code sigue un patrón consistente que minimiza conflictos y mantiene un historial claro.

1 - Ciclo completo:

main → crear feature/nueva-funcionalidad → desarrollar → merge → eliminar rama

2 - Buenas prácticas:

• Crear ramas descriptivas desde main actualizada
• Realizar commits frecuentes durante el desarrollo
• Probar la funcionalidad antes de fusionar
• Fusionar cuando la funcionalidad esté completa
• Eliminar ramas inmediatamente después de la fusión

3 - Sincronización regular:

Durante el desarrollo de una rama de funcionalidad, es recomendable sincronizar periódicamente con main para evitar conflictos grandes al momento de la fusión. VS Code facilita esta operación mediante pull requests o fusiones intermedias según el flujo del equipo.