Semantische Versionsnummern nach SemVer vergleichen

Vergleichen Sie zwei semantische Versionsnummern, ohne sich auf lexikalische Sortierung, Gleitkommakonvertierung oder paketmanagerspezifische Abkürzungen zu verlassen. Diese Funktion prüft beide Eingaben nach Semantic Versioning 2.0.0 und wendet anschließend die offiziellen Vorrangregeln auf Haupt-, Neben-, Patch- und Vorabkomponenten an. Sie meldet, ob die erste Version einen niedrigeren, höheren oder gleichen Vorrang gegenüber der zweiten hat, und ignoriert Build-Metadaten ordnungsgemäß. Ungültige oder unvollständige Versionsangaben erzeugen einen eindeutigen Eingabefehler statt einer irreführenden Reihenfolge.

Vergleichen Sie Versionen nach den Regeln echter Software-Releases

Ein gewöhnlicher Zeichenfolgenvergleich liefert bei vielen Versionsnummern ein falsches Ergebnis. Eine lexikalische Sortierung kann beispielsweise 2.10.0 vor 2.9.0 einordnen, weil sie das Zeichen 1 mit 9 vergleicht. Eine einfache Zahlenkonvertierung wiederum beseitigt die getrennte Bedeutung der Haupt-, Neben- und Patchpositionen.

Dieser semantische Vergleicher analysiert jede vorgeschriebene Position einzeln und vergleicht sie von links nach rechts. Er weist auch lockere Formen zurück, etwa eine fehlende Patchkomponente, ein vorangestelltes v oder eine numerische Kernkennung mit führender Null. Diese strenge Prüfung ist in Bereitstellungsskripten, Paketregistern, Aktualisierungsdiensten und CI-Prüfungen wertvoll, weil fehlerhafte Daten nicht unbemerkt als gültiges Release durchgehen.

Übermitteln Sie die erste und zweite Version genau in der veröffentlichten Schreibweise. Das Ergebnis enthält einen vorzeichenbehafteten Vorrangwert: minus eins bedeutet, dass die erste niedriger ist, null bezeichnet Gleichrangigkeit und eins bedeutet, dass die erste höher ist. Ein beschreibendes Vergleichsfeld macht dieselbe Antwort für Oberflächen und Workflow-Bedingungen leicht nutzbar.

Verstehen Sie Vorab-Reihenfolge und Build-Metadaten

Bei Vorabkennungen versagen vereinfachte Vergleicher besonders häufig. Ein Release mit Vorabsuffix hat einen niedrigeren Vorrang als dieselbe Haupt-, Neben- und Patchversion ohne diesen Zusatz. Deshalb ist 1.0.0-rc.1 niedriger als 1.0.0.

Sind beide Versionen Vorabversionen, werden ihre Kennungen der Reihe nach verglichen. Numerische Kennungen werden nach ihrem Zahlenwert, nichtnumerische nach lexikalischer ASCII-Reihenfolge verglichen; eine numerische Kennung hat immer einen niedrigeren Vorrang als eine nichtnumerische. Stimmen alle gemeinsamen Kennungen überein, hat die Version mit weiteren Kennungen den höheren Vorrang.

Diese Regeln bilden die übliche Entwicklung von alpha über beta bis zu Release Candidates ab, ohne bestimmten Wörtern eine Sonderbedeutung zu geben. Build-Metadaten nach einem Pluszeichen werden geprüft, aber bewusst vom Vorrang ausgeschlossen. Daher gelten 1.0.0+linux und 1.0.0+windows trotz unterschiedlicher Zeichenfolgen als gleichrangig.

Nutzen Sie strenge Vergleiche sicher in Automatisierungen

Ein deterministisches Vergleichsergebnis kann in größeren Systemen als kleiner, zuverlässiger Entscheidungspunkt dienen. Eine Release-Pipeline kann verlangen, dass die vorgeschlagene Version höher als die bereitgestellte ist. Ein Aktualisierungsprogramm kann entscheiden, ob ein heruntergeladenes Manifest ein Upgrade, ein Downgrade oder einen gleichrangigen Build beschreibt.

Eine Testsuite kann die kanonische Folge von Vorabversionen abdecken und ungültige Kennungen vor der Veröffentlichung von Artefakten zurückweisen. Die Implementierung stellt keine Netzwerkanfragen, liest keine Uhrzeit und verwendet keine Zufallswerte; gleiche Eingaben erzeugen stets dieselbe Ausgabe. Numerische Kennungen werden als Ziffernfolgen verglichen und nicht in JavaScript-Zahlen umgewandelt.

Dadurch bleibt die Reihenfolge selbst dann korrekt, wenn eine gültige Kennung den sicheren Ganzzahlbereich überschreitet. Die Eingabelänge ist begrenzt, damit die Verarbeitung überschaubar bleibt.