Giới thiệu Tính toán phiên bản SemVer — Hướng dẫn chi tiết
Công cụ Tính toán phiên bản SemVer (SemVer Calculator) phân tích và đánh giá các chuỗi phiên bản ngữ nghĩa (SemVer 2.0.0) cùng các ràng buộc phạm vi phụ thuộc. Công cụ bóc tách Major, Minor, Patch, thẻ phát hành trước (Prerelease) và siêu dữ liệu bản dựng (Build metadata) thành các thành phần có cấu trúc.
Kiểm tra các phạm vi semver trong file package.json của npm (bao gồm `^1.2.3`, `~1.2.3`, `>=1.0.0 <2.0.0`, `1.x`, ký tự đại diện `*`, và các biểu thức kết hợp `||`) để xác minh tính tương thích, sắp xếp mảng phiên bản và xem trước các mức tăng phiên bản kế tiếp được đề xuất.
Tính năng và khả năng nổi bật
- Phân tích cú pháp đầy đủ đặc tả SemVer 2.0.0 (Major.Minor.Patch-prerelease+build)
- Đánh giá các biểu thức phạm vi npm: dấu mũ (^), dấu ngã (~), phép so sánh và biểu thức hợp logic
- Chẩn đoán so sánh và sắp xếp phiên bản nghiêm ngặt (gt, lt, eq, satisfies)
- Tự động tính toán phiên bản kế tiếp với bản xem trước các mức tăng phát hành Major, Minor và Patch
Cách sử dụng
- 1
Nhập phiên bản cơ sở (ví dụ: `2.4.1`) hoặc biểu thức phạm vi (ví dụ: `^2.3.0`).
- 2
Nhập phiên bản phát hành ứng viên để kiểm tra xem phiên bản đó có thỏa mãn phạm vi đã chỉ định hay không.
- 3
Xem kết quả kiểm tra độ thỏa mãn, các token đã phân tích và đề xuất tăng phiên bản kế tiếp.
Trường hợp sử dụng phổ biến
- → Gỡ lỗi sai lệch phiên bản phụ thuộc không mong muốn do phạm vi dấu mũ (`^`) trong package.json
- → Xác định phiên bản phát hành kế tiếp chính xác trước khi chạy npm publish hoặc git tag
- → Xác thực các ràng buộc phạm vi trong không gian làm việc monorepo và các script build CI/CD dùng chung
Công cụ liên quan
Tạo thẻ Meta SEO & OpenGraph
Tạo bộ thẻ meta chuẩn cho SEO, OpenGraph (Facebook) và Twitter Card với trình xem trước trực quan.
Tạo tệp .gitignore
Tạo tệp .gitignore hoàn chỉnh cho Node.js, Python, Java, Go, Rust, macOS, Windows và IDE.
Tạo giấy phép mã nguồn mở
Chọn và tạo văn bản giấy phép mã nguồn mở phổ biến (MIT, Apache 2.0, GPL 3.0, BSD) với thông tin bản quyền.
Tạo tài liệu README.md
Tạo tệp tài liệu README.md chuyên nghiệp cho dự án với các huy hiệu (Badges), hướng dẫn cài đặt và cấu trúc mã nguồn.
Soạn thảo Conventional Commits
Trình soạn thảo thông điệp commit chuẩn hóa theo quy ước Conventional Commits (feat, fix, docs, chore).
Trình xem Swagger / OpenAPI
Hiển thị tài liệu đặc tả OpenAPI và Swagger trực quan, kiểm tra tham số endpoint và xem mô hình dữ liệu.
Câu hỏi thường gặp và quyền riêng tư
Sự khác biệt quan trọng giữa `^` (dấu mũ) và `~` (dấu ngã) là gì?
`~1.2.3` chỉ cho phép các bản phát hành PATCH (khớp với `>=1.2.3 <1.3.0`), trong khi `^1.2.3` cho phép cả các bản phát hành MINOR và PATCH (khớp với `>=1.2.3 <2.0.0`).
Siêu dữ liệu bản dựng (ví dụ: `+build123`) có ảnh hưởng đến thứ tự ưu tiên phiên bản không?
Không. Theo mục 10 của đặc tả SemVer, siêu dữ liệu bản dựng hoàn toàn mang tính chất thông tin và bắt buộc phải được bỏ qua khi xác định thứ tự ưu tiên của phiên bản.