Bộ tính toán SemVer

Công cụ này hiển thị gì

Đối với một phiên bản như 1.2.3, công cụ sẽ hiển thị bốn phiên bản tiếp theo được đề xuất:

Nâng minor sẽ đặt lại patch về 0; nâng major sẽ đặt lại cả minor và patch về 0. Đề xuất prerelease đánh dấu patch tiếp theo là ứng viên phát hành. Các công cụ dòng lệnh như npm version cung cấp thêm nhiều thao tác khác (premajor, preminor, prepatch, và tăng prerelease tại chỗ như 1.2.3-beta.1 chuyển thành 1.2.3-beta.2) nếu bạn cần chúng trong một script phát hành.

Các quy tắc ưu tiên mà bạn sẽ gặp phải

• Phiên bản tiền phát hành có thứ tự ưu tiên thấp hơn so với phiên bản chính thức: 1.0.0-rc.1 < 1.0.0.
• Các mã định danh số được so sánh theo giá trị số; các mã chữ số được so sánh theo bảng chữ cái: 1.0.0-alpha.2 < 1.0.0-alpha.11.
• Siêu dữ liệu bản dựng (+sha.abc) bị bỏ qua về thứ tự ưu tiên. Các phiên bản 1.0.0+20240101 và 1.0.0+20250101 có cùng mức độ ưu tiên.
• Chữ số 0 đứng đầu trong mã định danh số học là không hợp lệ. 1.0.0-rc.01 không phải là semver; hãy sử dụng rc.1.

Bảng hướng dẫn các giá trị phạm vi

• ^1.2.3, bất kỳ phiên bản nào từ 1.2.3 trở lên nhưng dưới 2.0.0 (phải thuộc cùng một phiên bản chính).
• ~1.2.3, bất kỳ phiên bản nào từ 1.2.3 trở lên nhưng dưới 1.3.0 (giữ nguyên phiên bản con tương ứng).
• >=1.2.3 <2.0.0, phạm vi rõ ràng.
• 0.x là trường hợp đặc biệt: npm coi ^0.2.3 như >=0.2.3 <0.3.0 vì phiên bản trước 1.0 được xem là không ổn định.

Khi nào nên nâng cấp phiên bản chính

Hãy nâng major cho bất kỳ thay đổi nào phá vỡ những người dùng ở hạ nguồn: gỡ bỏ API công khai, thay đổi chữ ký hàm, thay đổi hành vi mặc định hoặc đổi tên khóa cấu hình. Minor chỉ dành cho các thay đổi bổ sung. Patch dùng để khắc phục lỗi mà không làm thay đổi giao ước (hợp đồng).