Semantische Versionierung (SemVer) ist die Regel, Versionsnummern als Hauptfassung, Nebenfassung und Korrektur zu lesen. Aus 2.4.1 wird damit eine Auskunft darüber, was ein Update bedeutet.
- Semantische Versionierung (SemVer)
Die Regel, Versionsnummern als Hauptfassung, Nebenfassung und Korrektur zu lesen.
Beispiel: „Nach semantischer Versionierung war der Sprung von 2.4 auf 3.0 der teure.“Englisch Semantic Versioning, kurz SemVer. Die drei Stellen heißen major, minor und patch; Vorabfassungen hängen einen Zusatz an, etwa 3.0.0-beta.1.
Abgrenzung zur Datumsversion: Fassungen wie 2026.11 nennen den Zeitpunkt. Sie sagen nichts darüber, ob ein Update bricht.
Wie eine Versionsnummer nach semantischer Versionierung zu lesen ist
Von links nach rechts nach Tragweite. Die erste Stelle steigt, wenn etwas entfernt oder umgebaut wurde und bestehender Code deshalb bricht. Die zweite steigt bei neuen Funktionen, die nichts kaputt machen. Die dritte bei Korrekturen.
Daraus folgt die Reihenfolge der Aufmerksamkeit: Die dritte Stelle lässt sich fast immer einspielen, die zweite meist, die erste will gelesen werden, siehe Changelog.
Was die Zeichen in Abhängigkeiten bedeuten
Sie legen fest, wie weit ein Paket mitwachsen darf. Eine Angabe mit Dach erlaubt alles bis zur nächsten Hauptfassung, eine mit Tilde nur die Korrekturen innerhalb einer Nebenfassung, eine nackte Nummer genau diese Fassung.
Deshalb installiert dasselbe Projekt auf zwei Rechnern verschiedene Pakete, solange keine Sperrdatei dabei ist. Diese Datei hält die Entscheidung fest, die die Zeichen offen lassen.
Wo SemVer in der Praxis bricht
An der Auslegung. Was als brechende Änderung zählt, entscheidet der Herausgeber, und manche heben die erste Stelle für Marketing oder lassen sie trotz Umbau stehen. Die Null am Anfang ist ohnehin ausgenommen: Vor 1.0 darf jede Fassung brechen.
Verlassen sollte sich darauf also niemand allein. Die Nummer ist ein Hinweis, der Changelog die Auskunft, und ein Testlauf in der Entwicklungsumgebung die Sicherheit, siehe Dev-Umgebung.