SemVer Rechner

Was dieser Rechner anzeigt

Für eine Version wie 1.2.3 zeigt das Tool vier vorgeschlagene nächste Versionen an:

Das Erhöhen der Nebenversion setzt die Patchversion auf 0 zurück; das Erhöhen der Hauptversion setzt sowohl die Neben- als auch die Patchversion auf 0 zurück. Der Vorabversions-Vorschlag markiert die nächste Patchversion als Release-Kandidat. Befehlszeilen-Tools wie npm version fügen weitere Operationen hinzu (premajor, preminor, prepatch sowie Vorabversions-Inkremente an Ort und Stelle wie 1.2.3-beta.1 zu 1.2.3-beta.2), falls Sie diese in einem Release-Skript benötigen.

Vorrangregeln, die Sie treffen werden

• Eine Vorabversion hat geringeren Vorrang als die Release-Version: 1.0.0-rc.1 < 1.0.0.
• Numerische Identifikatoren vergleichen numerisch; alphanumerische vergleichen lexikalisch: 1.0.0-alpha.2 < 1.0.0-alpha.11.
• Build-Metadaten (+sha.abc) werden für den Vorrang ignoriert. 1.0.0+20240101 und 1.0.0+20250101 sind gleichwertige Versionen.
• Eine führende Null in einem numerischen Identifikator ist ungültig. 1.0.0-rc.01 ist nicht semver; verwenden Sie rc.1.

Bereichsoperatoren Cheatsheet

• ^1.2.3, alles >=1.2.3 und <2.0.0 (bleibt bei der gleichen Hauptversion).
• ~1.2.3, alles >=1.2.3 und <1.3.0 (bleibt bei der gleichen Nebenversion).
• >=1.2.3 <2.0.0, expliziter Bereich.
• 0.x ist speziell: npm behandelt ^0.2.3 als >=0.2.3 <0.3.0, da Vorabversionen vor 1.0 als instabil gelten.

Wann man die Hauptversion erhöhen sollte

Erhöhen Sie die Hauptversion für jede Änderung, die nachgelagerte Verbraucher bricht: entfernte öffentliche API, geänderte Funktionssignatur, geändertes Standardverhalten, umbenannter Konfigurationsschlüssel. Eine Nebenversion ist nur für additive Änderungen gedacht. Ein Patch ist für Fehlerbehebungen, die den Vertrag nicht ändern.