Kalkulator SemVer

Co pokazuje ten kalkulator

Dla wersji takiej jak 1.2.3 narzędzie pokazuje cztery sugerowane następne wersje:

Podniesienie minor zeruje patch (0); podniesienie major zeruje zarówno minor, jak i patch (0). Sugestia prerelease oznacza następny patch jako kandydata do wydania. Narzędzia wiersza poleceń takie jak npm version dodają więcej operacji (premajor, preminor, prepatch oraz zwiększanie prerelease w miejscu, np. 1.2.3-beta.1 zmienia się na 1.2.3-beta.2), jeśli potrzebujesz ich w skrypcie wydania.

Zasady priorytetu, na które musisz zwrócić uwagę

• Wersja przedwydawnicza ma niższy priorytet niż wersja oficjalna: 1.0.0-rc.1 < 1.0.0.
• Identyfikatory liczbowe porównywane są na podstawie wartości liczbowej; identyfikatory alfanumeryczne – na podstawie kolejności leksykalnej: 1.0.0-alpha.2 < 1.0.0-alpha.11.
• Metadane kompilacji (+sha.abc) są ignorowane pod kątem priorytetu; wersje 1.0.0+20240101 i 1.0.0+20250101 są równoważne.
• Wiodące zero w liczbowym identyfikatorze jest nieprawidłowe. 1.0.0-rc.01 nie jest poprawnym formatem semver; użyj rc.1.

Spis informacji o zakresach wartości

• ^1.2.3 – wszystkie wersje od 1.2.3 do 2.0.0 (z zachowaniem tej samej wersji głównej).
• ~1.2.3 – wszystkie wersje od 1.2.3 do 1.3.0 (zachowują tę samą wersję podrzędną).
• >=1.2.3 <2.0.0 – wyraźny zakres.
• 0.x jest wyjątkowy: npm traktuje ^0.2.3 jako >=0.2.3 <0.3.0, ponieważ wersje przed 1.0 są uznawane za niestabilne.

Kiedy podnieść wersję główną (major)

Podnieś major przy każdej zmianie, która psuje odbiorców w dół strumienia: usunięty publiczny interfejs API, zmieniony podpis funkcji, zmienione domyślne zachowanie lub zmieniona nazwa klucza konfiguracji. Minor dotyczy wyłącznie zmian dodatkowych. Poprawka służy do naprawy błędów, które nie zmieniają kontraktu.