Nasıl kullanılır?
- Bir Sürüm yazın, örneğin 1.4.0; sıralamak için isterseniz Şununla karşılaştır alanına başka bir sürüm yazın.
- Sonraki sürümü görmek için bir Artırma seçin. Önsürüm artırması için adını Önsürüm adı alanına yazın.
- Sürümün bir Aralık karşılayıp karşılamadığını görmek için aralık yazın; aralığın her parçasının anlamını Aralık nasıl okunur bölümünden okuyun.
- İhtiyacınız olan yanıt için Artırılmış sürüm, Sıralama ve Aralık denetimi sonuçlarını okuyun.
Sürümler nasıl sıralanır
SemVer 2.0.0, majör, minör ve yama sayılarını sayı olarak karşılaştırır. Önsürüm etiketi olan bir sürüm, etiketsiz aynı sürümden önce gelir. Önsürüm tanımlayıcıları tek tek karşılaştırılır: sayılar sayı olarak, metinler ASCII sırasına göre ve bir sayı, bir metinden önce gelir. + işaretinden sonraki derleme bilgisi sayılmaz.
- Belirtimdeki örneklerin sırası: 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.
- v1.4.0 gibi baştaki v harfi kabul edilir ve sürümün parçası sayılmaz.
Artırma nasıl çalışır
Majör artırma ilk sayıyı bir yükseltir ve diğer ikisini 0 yapar; minör ve yama artırmaları kendi parçası için aynısını yapar. Önsürüm durumundaki bir sürüm, artırma zaten sürümü yükseltecekse etiketini kaybeder: 1.0.0-alpha, majör artırmada 1.0.0 olur; node-semver de böyle yapar. Önsürüm artırması, verdiğiniz adla sonraki yamayı başlatır (örneğin 1.4.1-beta.0) ya da mevcut bir önsürümün son sayısını artırır (beta.1 → beta.2).
Aralıklar nasıl okunur
Aralık sözdizimi, npm'in kullandığı node-semver paketini ve README dilbilgisini izler. Her biçim karşılaştırıcılara karşılık gelir: ^1.3.0, >=1.3.0 <2.0.0-0 anlamına gelir; ~1.2.3, >=1.2.3 <1.3.0-0 anlamına gelir; 1.2.x ise >=1.2.0 <1.3.0-0 anlamına gelir. Bir kümenin içindeki karşılaştırıcıların hepsi tutmalıdır. || ile ayrılmış kümeler alternatiftir; boş bir küme, * gibi her sürümü kabul eder.
Önsürümler ve aralıklar
1.5.0-beta.1 gibi bir önsürüm sürümü, ancak kümesindeki bir karşılaştırıcı aynı 1.5.0 değerini bir önsürüm etiketiyle belirtiyorsa bir aralığı karşılar. Böylece tamamlanmamış sürümler varsayılan olarak aralıkların dışında kalır; node-semver'ın README'si bunu açıklar. Bu sayfadaki denetim bu kuralı izler.
Örnek: 1.4.0, minör artırma ve ^1.3.0 || 2.x
1.4.0 sürümü, bir sürüm önsürümünden yüksek olduğu için 1.4.0-beta.2 sürümünden yüksektir. Minör artırma 1.5.0 verir. ^1.3.0 || 2.x aralığı >=1.3.0 <2.0.0-0 ya da >=2.0.0 <3.0.0-0 olarak okunur ve 1.4.0 ilk kümeyi karşılar.
| Girdi | Sonuç |
|---|---|
| 1.4.0, 1.4.0-beta.2 ile karşılaştırılırsa | 1.4.0 sürümü, 1.4.0-beta.2 sürümünden yüksektir. |
| 1.4.0 için minör artırma | 1.5.0 |
| 1.4.0, ^1.3.0 || 2.x içinde | 1.4.0 sürümü ^1.3.0 || 2.x aralığını karşılar. |
Sık sorulan sorular
1.0.0+build.1, 1.0.0 ile aynı sürüm müdür?
Sıralama ve aralıklar bakımından evet. + işaretinden sonraki derleme bilgisi SemVer önceliğinde sayılmaz; bu yüzden iki sürüm bir sıralamada aynı yeri alır. Sayfa derleme bilgisini yine de gösterir ki görebilesiniz.
Neden 1.4.0-beta.2, 1.4.0'dan düşüktür?
Önsürüm kararsızdır ve numarasının vaat ettiği uyumluluğu karşılamayabilir; bu yüzden SemVer onu aynı sayılı sürümden önce yerleştirir. Böylece 1.4.0-beta.2, 1.4.0'dan önce; 1.4.0 ise 1.4.1'den önce gelir.
^1.3.0 aralığı 2.0.0 sürümünü kabul eder mi?
Hayır. Caret aralığı soldaki sıfır olmayan sayıyı korur; bu yüzden ^1.3.0, en az 1.3.0 ve 2.0.0'ın altı anlamına gelir. İkinci majörü de kabul etmek için örnekteki gibi || 2.x yazın.
~1.2 ile ^1.2 arasındaki fark nedir?
~1.2 aralığı >=1.2.0 <1.3.0-0 anlamına gelir; bu yüzden 1.2.9 gibi yama değişikliklerini kabul eder, 1.3.0'ı reddeder. ^1.2 aralığı >=1.2.0 <2.0.0-0 anlamına gelir; bu da 1.3.0 ve 1.9.9'u kabul eder, ancak 2.0.0'ı kabul etmez.
Neden bir aralık 1.5.0-beta.1 sürümünü reddediyor?
Önsürümler, bir karşılaştırıcı aynı sürümü bir önsürüm etiketiyle (örneğin >=1.5.0-beta.0) belirtmedikçe dışarıda bırakılır. node-semver bu seçimi yapar; çünkü önsürümler hızla değişir ve sorun çıkarabilir.
Sürümlerim bir sunucuya gönderiliyor mu?
Hayır. Sürüm, aralık ve karşılaştırma tarayıcınızda okunur ve denetlenir; yazdıklarınız hiçbir yerde saklanmaz.
Kaynaklar
- Semantic Versioning 2.0.0 belirtimi (semver.org)
- node-semver README: aralıklar ve aralık dilbilgisi (npm)
- node-semver README: önsürüm etiketleri (npm)
- node-semver deposu, ISC lisansı (npm)
Rakamlar ve metin en son 10 Kasım 2026 Salı tarihinde kontrol edildi.