Branches :: amis13

important

Esta página cubre el trabajo con branches/ramas y tags en GitHub: cómo crearlos, cambiarlos, publicarlos, listarlos y borrarlos. Úsala cuando ya tengas el repositorio configurado y necesites organizar desarrollo, publicar una versión o marcar un punto estable del proyecto.

1) Branches / ramas

1.1 Crear una branch nueva

git branch nombre-del-branch

Este comando crea la branch, pero no cambia a ella.

1.2 Crear una branch y cambiarte a ella

git checkout -b nombre-del-branch

Ejemplo:

git checkout -b feature/login

validated

Si tu versión de Git lo permite, también puedes usar:
git switch -c feature/login
switch es más claro para cambiar de branch, mientras que checkout también se usa para otras tareas históricas de Git.

1.3 Cambiar de branch

git checkout nombre-del-branch

O, de forma más explícita:

git switch nombre-del-branch

1.4 Subir una branch a GitHub

git push origin nombre-del-branch

Esto publica la branch en el remoto origin.

1.5 Ver branches

Branches locales:

git branch

Branches remotas:

git branch -r

Todas las branches:

git branch -a

1.6 Borrar una branch

Borrado seguro en local:

git branch -d nombre-del-branch

Forzar borrado en local:

git branch -D nombre-del-branch

Borrar la branch remota:

git push origin --delete nombre-del-branch

warning

Usa -d cuando la branch ya fue fusionada o ya no contiene trabajo pendiente. Usa -D solo si estás seguro de que quieres eliminarla aunque tenga cambios no integrados.

2) Tags

Los tags sirven para marcar versiones exactas del código, por ejemplo v1.0.0.

A diferencia de una branch, un tag apunta a un commit concreto y no se mueve con nuevos cambios.

2.1 Crear un tag anotado

git tag -a v1.0.0 -m "Primera versión estable"

Este es el formato recomendado para releases porque guarda más contexto.

2.2 Crear un tag en un commit específico

git tag -a v1.0.1 <commit-hash> -m "Hotfix login"

2.3 Ver tags

git tag

Para ver el detalle de un tag:

git show v1.0.0

2.4 Subir tags a GitHub

Subir un tag concreto:

git push origin v1.0.0

Subir todos los tags:

git push origin --tags

important

Si el release depende de una branch concreta, conviene empujar primero esa branch y después publicar el tag. Así aseguras que el remoto tenga exactamente el commit que estás versionando.

3) Relación entre branch y tag

Branch: línea de desarrollo activa; cambia con cada commit nuevo.
Tag: marcador fijo sobre un commit; representa una versión cerrada.

Diferencia práctica

Usa una branch para trabajar, integrar cambios y preparar una feature.
Usa un tag para señalar una versión lista para distribuir, desplegar o documentar.

Ejemplo de uso combinado

git checkout -b feature/x
# trabajas y haces commits
git checkout main
git merge feature/x
git tag -a v0.0.3 -m "Nueva feature X"
git push origin main
git push origin v0.0.3

4) Flujo recomendado

Crea una branch para el trabajo.
Desarrolla y confirma cambios con commits.
Fusiona la branch en main.
Crea un tag anotado si quieres marcar una versión.
Sube primero la branch y después el tag.

git checkout -b feature/x
# trabajas
git checkout main
git merge feature/x
git tag -a v0.0.3 -m "Nueva feature X"
git push origin main
git push origin v0.0.3

validated

Si quieres limpiar el repositorio después de fusionar, borra la branch local con git branch -d y, si procede, elimina también la branch remota.

5) Resumen rápido

git branch nombre → crea una branch.
git checkout -b nombre → crea y cambia a una branch.
git checkout nombre → cambia de branch.
git push origin nombre → sube la branch al remoto.
git branch -d nombre → borra una branch local fusionada.
git branch -D nombre → fuerza el borrado local.
git tag -a v1.0.0 -m "..." → crea un tag anotado.
git push origin v1.0.0 o git push origin --tags → publica tags.

- EOF -