Startseite › Entwickler-Tools › Semantic-Versioning-Rechner

Semantic-Versioning-Rechner

Ermittle die nächste Versionsnummer, prüfe, welche von zwei Versionen neuer ist, sieh genau, was ein npm-Bereich wie ^1.2.0 oder ~1.4 erlaubt, oder sortiere eine unordentliche Versionsliste – alles nach den offiziellen Rangfolgeregeln von SemVer 2.0.0.

Zuletzt aktualisiert:

Was möchtest du tun?

Wird von den pre*-Erhöhungsarten verwendet, wie npm version --preid

npm-Syntax: ^1.2.3, ~1.2, 1.x, >=1.0.0 <2.0.0, 1.0.0 - 1.5.0, verknüpft mit ||

Gib deine Werte ein, um das Ergebnis zu sehen.
Anzeige
Anzeige

Anleitung: Semantic-Versioning-Rechner

  1. Wähle eine Aufgabe: Erhöhen, Vergleichen, Bereichstest oder Sortieren.
  2. Gib deine Version(en) ein. Ein vorangestelltes v (v1.2.3) wird akzeptiert; Build-Metadaten nach + bleiben erhalten, werden bei der Reihenfolge aber ignoriert.
  3. Zum Erhöhen wählst du die Art der Erhöhung und bei Pre-Releases ein Label wie beta.
  4. Für einen Bereich fügst du den Bereich aus der package.json und die zu testenden Versionen ein.
  5. Lies das Ergebnis und den Rechenweg und kopiere es dann oder lade die Tabelle als CSV herunter.

SemVer-Rangfolge in vier Regeln

  1. MAJOR, MINOR und PATCH als Zahlen vergleichen, von links nach rechts. Der erste Unterschied entscheidet: 2.0.0 > 1.99.99 und 1.10.0 > 1.9.0.
  2. Ein Pre-Release rangiert unter seinem Release: 1.0.0-rc.1 < 1.0.0.
  3. Pre-Release-Bezeichner werden einzeln verglichen: Zahlen numerisch (beta.2 < beta.11), Wörter in ASCII-Reihenfolge (alpha < beta < rc), und eine Zahl rangiert immer unter einem Wort.
  4. Mehr Bezeichner gewinnen, wenn alle vorherigen gleich sind: 1.0.0-alpha < 1.0.0-alpha.1. Build-Metadaten nach + zählen nie.

Vollständige Beispielreihenfolge: 1.0.0-alpha < 1.0.0-alpha.1 < 1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0-rc.1 < 1.0.0.

Spickzettel für npm-Bereiche

BereichBedeutungErlaubt zum Beispiel
^1.2.3>=1.2.3 <2.0.0-01.2.3, 1.3.0, 1.99.0
^0.2.3>=0.2.3 <0.3.0-00.2.3, 0.2.9 (nicht 0.3.0)
^0.0.3>=0.0.3 <0.0.4-0nur 0.0.3
~1.2.3>=1.2.3 <1.3.0-01.2.3, 1.2.10
~1>=1.0.0 <2.0.0-01.0.0 bis 1.x.x
1.2.x oder 1.2>=1.2.0 <1.3.0-01.2.0, 1.2.7
1.2.3 - 2.3>=1.2.3 <2.4.0-01.2.3 bis 2.3.x
>1.2>=1.3.01.3.0 und später
<=1.2<1.3.0-0alles bis 1.2.x
* oder "" oder xjede Versionjedes stabile Release
A || BA oder B^1.0.0 || ^2.0.0

Welche Zahl soll ich erhöhen?

Deine ÄnderungErhöhungAus 1.4.2 wird
Fehler behoben, keine API-Änderungpatch1.4.3
Funktion hinzugefügt, alter Code funktioniert weiterminor1.5.0
Etwas entfernt oder geändert, auf das Nutzer angewiesen sindmajor2.0.0
Nächste Major-Version vor dem Release testenpremajor --preid=beta2.0.0-beta.0
Ein weiterer Test-Buildprerelease2.0.0-beta.1

Versionen 0.y.z sind für die anfängliche Entwicklung gedacht: Alles kann sich jederzeit ändern, deshalb behandelt das Caret die erste Zahl ungleich null als „Major“. Veröffentliche 1.0.0, sobald deine öffentliche API stabil ist.

Häufige Fragen

Was ist semantische Versionierung?

Semantic Versioning (SemVer 2.0.0) schreibt Versionen als MAJOR.MINOR.PATCH. MAJOR erhöhst du bei inkompatiblen API-Änderungen, MINOR bei abwärtskompatiblen Funktionen und PATCH bei abwärtskompatiblen Fehlerbehebungen. Optional können ein Pre-Release-Teil (-beta.1) und ein Build-Teil (+sha.5114f85) folgen.

Was ist der Unterschied zwischen ^ und ~ in der package.json?

Das Caret erlaubt Änderungen, die die am weitesten links stehende Zahl ungleich null nicht verändern: ^1.2.3 bedeutet >=1.2.3 <2.0.0, aber ^0.2.3 bedeutet >=0.2.3 <0.3.0. Die Tilde erlaubt nur Patch-Updates, wenn eine Minor-Version angegeben ist: ~1.2.3 bedeutet >=1.2.3 <1.3.0.

Warum ist 1.10.0 neuer als 1.9.0?

Jeder Teil wird als ganze Zahl verglichen, nicht als Text. 10 ist größer als 9, daher hat 1.10.0 den höheren Rang, auch wenn es alphabetisch früher einsortiert würde.

Ist 1.0.0-rc.1 höher oder niedriger als 1.0.0?

Niedriger. Eine Pre-Release-Version rangiert unter dem normalen Release mit demselben MAJOR.MINOR.PATCH, also 1.0.0-alpha < 1.0.0-beta < 1.0.0-rc.1 < 1.0.0.

Warum passt ^1.2.0 nicht auf 1.5.0-beta.1?

npm überspringt Pre-Releases, außer ein Vergleich im selben Teil des Bereichs hat ebenfalls ein Pre-Release auf demselben MAJOR.MINOR.PATCH. So bekommen Nutzer nicht versehentlich instabile Builds. Aktiviere „Pre-Releases einschließen“, um sie trotzdem zu erfassen – wie mit dem Flag --include-prerelease.

Was bedeutet die -0 in <2.0.0-0?

Es ist das niedrigstmögliche Pre-Release von 2.0.0. Schreibt man die Obergrenze als <2.0.0-0, werden alle Pre-Releases von 2.0.0 und 2.0.0 selbst ausgeschlossen – so löst npm ^1.2.3 intern auf.

Beeinflussen Build-Metadaten die Versionsreihenfolge?

Nein. Alles nach einem Pluszeichen, etwa +build.42, wird bei der Rangfolge ignoriert, daher sind 1.0.0+a und 1.0.0+b gleichrangig.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Playgrounds & Tester ansehen →