Calculadora SemVer

Lo que muestra esta calculadora

Para una versión como 1.2.3, la herramienta muestra cuatro versiones siguientes sugeridas:

Aumentar menor reinicia parche a 0; aumentar mayor reinicia tanto menor como parche a 0. La sugerencia de prerelease marca el siguiente parche como candidata de lanzamiento. Las herramientas de línea de comandos como npm version añaden más operaciones (premajor, preminor, prepatch, e incrementos de prerelease en su lugar como 1.2.3-beta.1 que se convierte en 1.2.3-beta.2) si las necesitas dentro de un script de lanzamiento.

Reglas de precedencia que encontrarás

• Un prerelease tiene menor precedencia que el lanzamiento: 1.0.0-rc.1 < 1.0.0.
• Los identificadores numéricos se comparan numéricamente; los alfanuméricos se comparan léxicamente: 1.0.0-alpha.2 < 1.0.0-alpha.11.
• Los metadatos de construcción (+sha.abc) son ignorados para la precedencia. 1.0.0+20240101 y 1.0.0+20250101 son versiones iguales.
• Un cero inicial en un identificador numérico es inválido. 1.0.0-rc.01 no es semver; usa rc.1.

Hoja de trucos de operadores de rango

• ^1.2.3, cualquier cosa >=1.2.3 y <2.0.0 (se mantiene en el mismo mayor).
• ~1.2.3, cualquier cosa >=1.2.3 y <1.3.0 (se mantiene en el mismo menor).
• >=1.2.3 <2.0.0, rango explícito.
• 0.x es especial: npm trata ^0.2.3 como >=0.2.3 <0.3.0 porque pre-1.0 se considera inestable.

Cuándo aumentar mayor

Aumenta mayor por cualquier cambio que rompa a los consumidores posteriores: API pública eliminada, firma de función cambiada, comportamiento predeterminado cambiado, clave de configuración renombrada. Un menor es solo para cambios aditivos. Un parche es para correcciones de errores que no alteran el contrato.