Cómo usar: Generador de Conventional Commits
- Elige el tipo de cambio:
featpara una nueva funcionalidad,fixpara una corrección de errores, o docs, refactor, perf, test, build, ci, chore, style o revert. - Añade un ámbito opcional (la parte del código que afecta) y una descripción corta en modo imperativo: “añade”, no “añadió”.
- Explica qué y por qué en el cuerpo; marca Cambio incompatible y describe la migración si los usuarios deben cambiar algo.
- Añade footers como
Closes #123, corrige lo que marquen las revisiones y luego copia el mensaje o el comandogit commit.
El formato Conventional Commits
<type>[optional scope][!]: <description>
[optional body]
[optional footer(s)]| Tipo | Para qué sirve | Subida de versión |
|---|---|---|
feat | Una nueva funcionalidad | Minor (1.4.0 → 1.5.0) |
fix | Una corrección de errores | Patch (1.4.0 → 1.4.1) |
! o BREAKING CHANGE: | Un cambio al que los usuarios deben adaptarse | Major (1.4.0 → 2.0.0) |
| docs, style, refactor, perf, test, build, ci, chore, revert | Todo lo demás | Ninguna (salvo que sea incompatible) |
Herramientas como semantic-release, release-please y standard-version leen estos mensajes para elegir la siguiente versión y generar el changelog automáticamente; commitlint los aplica en CI o en un hook de git. Mantén la cabecera por debajo de 72 caracteres, empieza la descripción en minúsculas con un verbo en imperativo y no termines con punto. Genera un changelog con el Generador de changelog y otros comandos git con el Generador de comandos Git.
También se busca como: mensajes de commit conventional commits, generador conventional commits, generador de mensajes de commit, formato de mensajes de commit git, semantic commit messages, commitlint, feat fix commit, cambio incompatible commit.
Herramientas que combinan con: Generador de Conventional Commits
- Calculadora Semver — Todo sobre versiones semánticas en un solo lugar: compara dos versiones, calcula la siguiente major/minor/patch/prerelease y mira exactamente qué versiones permite un rango de npm como ^1.2.0 o ~2.3, explicado en lenguaje sencillo.
- Chuleta de Git — Todos los comandos de Git que usas a diario, y los que necesitas cuando algo sale mal, explicados en una línea.
- Generador de flujos de trabajo de GitHub Actions — Elige tu pila, tus desencadenantes y tus pasos, y obtén un .github/workflows/ci.yml — instalación, caché, lint, pruebas, compilación, una matriz de versiones y, si quieres, una implementación en GitHub Pages, Vercel o un registro de contenedores.
- Generador de LICENSE — Añade la licencia open source adecuada a tu proyecto en segundos.
Preguntas frecuentes
¿Qué es un conventional commit?
Un mensaje de commit con el formato tipo(ámbito): descripción, por ejemplo fix(auth): handle expired tokens, que las herramientas pueden leer para decidir los números de versión y generar changelogs.
¿Cómo marco un cambio incompatible?
Añade ! después del tipo o del ámbito (feat(api)!: …) y un footer BREAKING CHANGE: que explique qué cambió. Marca Cambio incompatible aquí para obtener ambos.
¿Cuál es la diferencia entre chore y refactor?
refactor cambia la estructura del código sin cambiar su comportamiento; chore cubre el mantenimiento que no toca el comportamiento del código fuente, como actualizar dependencias o la configuración de herramientas.
¿Cómo escribo un mensaje de commit de varias líneas desde la terminal?
Usa un -m por párrafo: git commit -m "header" -m "body" -m "footer". El comando git de esta página lo hace por ti, con las comillas escapadas.
¿Puedo instalar Generador de Conventional Commits como aplicación web y utilizarla sin conexión?
Sí. Generador de Conventional Commits es una aplicación web instalable (PWA): se instala desde el navegador, no se descarga desde una tienda de aplicaciones. Haz clic en «Instalar aplicación» en la parte superior de esta página en Chrome o Edge (Windows, macOS, Linux, ChromeOS) o, en Android, utiliza «Compartir» → «Añadir a la pantalla de inicio» en iPhone y iPad, o «Archivo» → «Añadir al Dock» en Safari 17+ en un Mac. A continuación, se abrirá en su propia ventana con su propio icono y, como se ejecuta íntegramente en tu navegador, seguirá funcionando sin conexión. Firefox en el ordenador de sobremesa no permite instalar aplicaciones web. Cómo funciona la instalación.