Generador de nombres de ramas Git
Pega el ID de un ticket y su título y obtén un nombre de rama ordenado y válido, como feature/PROJ-1423-add-oauth-login, además del comando git para crearla. Elige una vez el prefijo, los separadores y el límite de longitud de tu equipo y se recordarán.
Última actualización:
Consejo: pega "PROJ-12: Fix crash" y deja el ID vacío; el ID se detecta automáticamente
0 = sin límite. Con 50–60 los nombres se leen bien en las herramientas
Cómo usar Generador de nombres de ramas Git
- Introduce el ID del ticket (PROJ-123, #42) y el título del ticket.
- Elige el tipo de rama, como feature o bugfix, o un prefijo personalizado.
- Define el estilo de tu equipo: separadores, mayúsculas del ticket, posición del ticket y longitud máxima.
- Haz clic en Generar (el nombre también se actualiza mientras escribes).
- Copia el nombre de la rama o el comando git y ejecútalo en tu terminal.
Prefijos habituales de tipo de rama
| Prefijo | Úsalo para | Ejemplo |
|---|---|---|
| feature/ | Funcionalidad nueva | feature/PROJ-88-export-to-csv |
| bugfix/ o fix/ | Correcciones de errores no urgentes en la rama de desarrollo | fix/482-empty-upload-crash |
| hotfix/ | Correcciones urgentes creadas desde producción | hotfix/OPS-77-webhook-retry-500 |
| release/ | Estabilizar una versión antes de publicarla | release/v2.4.0 |
| chore/ | Herramientas, actualizaciones de dependencias, mantenimiento | chore/update-eslint-config |
| docs/ | Solo documentación | docs/api-auth-examples |
| refactor/ | Cambios de código sin comportamiento nuevo | refactor/split-user-service |
| test/ | Adding or fixing tests | test/payment-edge-cases |
The type names match Conventional Commits types (feat, fix, chore, docs…), so many teams use the same word in the branch name and the commit message.
Rules this generator applies
- Palabras en minúsculas separadas por guiones: evita conflictos de mayúsculas en Windows y macOS, donde Feature/Login y feature/login pueden chocar.
- Solo ASCII: se quitan los acentos (café → cafe) y se eliminan símbolos como &, !, emojis y comillas.
- Ticket ID kept as typed or in uppercase, because tracker integrations usually match keys like PROJ-123.
- Whole-word trimming: when the name is too long, words are removed from the end of the description, never from the prefix or ticket.
- Git-safe: no spaces, no "..", no ~ ^ : ? * [ \, no leading dots and no trailing slash, dot or ".lock".
Preguntas frecuentes
¿Qué es una buena convención de nombres para ramas git?
Un patrón habitual es tipo/TICKET-descripción-corta, por ejemplo feature/PROJ-1423-add-oauth-login. El tipo agrupa las ramas, el ID del ticket vincula el trabajo con tu gestor de incidencias y unas pocas palabras en minúsculas separadas por guiones dicen de qué trata la rama.
¿Qué caracteres no se permiten en el nombre de una rama git?
Git rechaza los espacios, los caracteres de control, ~ ^ : ? * [ y la barra invertida, dos puntos seguidos (..), la secuencia @{, un componente que empiece por punto y los nombres que terminen en / o .lock. Este generador sustituye o elimina todos ellos.
¿Debe ir la clave del ticket de Jira en el nombre de la rama?
Se recomienda incluirla. Las integraciones de Jira, GitHub, GitLab y Bitbucket pueden vincular una rama a una incidencia cuando la clave (como PROJ-123) aparece en el nombre de la rama, y facilita rastrear las ramas antiguas.
¿Qué longitud debe tener el nombre de una rama?
Git no tiene un límite práctico, pero los nombres de más de unos 50 a 60 caracteres cuestan de leer en terminales, registros de CI y listas de pull requests. Deja de tres a seis palabras significativas después del ID del ticket.
¿Barra o guion después del tipo?
La barra (feature/login) es la opción más común porque muchas herramientas de git muestran los nombres separados por barras como carpetas. Ten en cuenta que no puedes tener a la vez una rama llamada feature y otra llamada feature/login, porque git las guarda como un archivo y una carpeta.
¿Qué diferencia hay entre git switch -c y git checkout -b?
Ambos crean una rama nueva y cambian a ella. git switch -c se añadió en Git 2.23 como un comando más claro para cambiar de rama; git checkout -b funciona en todas las versiones.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.