เกี่ยวกับ เครื่องคำนวณ Semantic Versioning — คู่มือการใช้งาน
เครื่องมือคำนวณ SemVer (SemVer Calculator) ใช้แจงส่วนและประเมินสตริงหมายเลขเวอร์ชันตามมาตรฐาน Semantic Versioning (SemVer 2.0.0) รวมถึงข้อจำกัดช่วงเวอร์ชันของดีเพนเดนซี โดยแยกย่อย Major, Minor, Patch, แท็ก Prerelease และเมทาดาทา Build ออกเป็นส่วนประกอบที่มีโครงสร้างชัดเจน
ทดสอบช่วงเวอร์ชัน SemVer ของ npm ใน package.json (รวมถึงนิพจน์ `^1.2.3`, `~1.2.3`, `>=1.0.0 <2.0.0`, `1.x`, ไวลด์การ์ด `*` และการเชื่อมด้วย `||`) เพื่อตรวจสอบความเข้ากันได้ จัดเรียงอาร์เรย์เวอร์ชัน และดูตัวอย่างการปรับเพิ่มเลขเวอร์ชันถัดไปที่แนะนำ
คุณสมบัติและความสามารถหลัก
- แจงส่วนข้อกำหนด SemVer 2.0.0 อย่างครบถ้วน (Major.Minor.Patch-prerelease+build)
- ประเมินนิพจน์ช่วงเวอร์ชันของ npm ทั้ง caret (^), tilde (~), ตัวดำเนินการเปรียบเทียบ และตรรกะแบบ union
- เปรียบเทียบเวอร์ชันอย่างเข้มงวดและวิเคราะห์การจัดเรียงลำดับ (gt, lt, eq, satisfies)
- คำนวณเวอร์ชันถัดไปโดยอัตโนมัติ พร้อมแสดงตัวอย่างการปรับเพิ่มระดับ Major, Minor และ Patch
วิธีใช้งาน
- 1
ป้อนเวอร์ชันฐาน (เช่น `2.4.1`) หรือนิพจน์ช่วงเวอร์ชัน (เช่น `^2.3.0`)
- 2
พิมพ์เวอร์ชันที่ต้องการทดสอบเพื่อตรวจสอบว่าสอดคล้องกับช่วงเวอร์ชันที่กำหนดไว้หรือไม่
- 3
ตรวจสอบผลการตรวจสอบความเข้ากันได้ โทเคนของส่วนประกอบที่แจงส่วนออกมา และคำแนะนำการปรับเพิ่มเวอร์ชันถัดไป
ตัวอย่างการใช้งานทั่วไป
- → ตรวจสอบและแก้ไขปัญหาดีเพนเดนซีเปลี่ยนแปลงโดยไม่คาดคิด (dependency drift) ที่เกิดจากช่วงเวอร์ชันแบบ caret (`^`) ใน package.json
- → ตัดสินใจเลือกเลขเวอร์ชันถัดไปที่ถูกต้องก่อนสั่งรัน npm publish หรือ git tag
- → ตรวจสอบข้อจำกัดช่วงเวอร์ชันในเวิร์กสเปซแบบ monorepo และสคริปต์การบิลด์ร่วมบน CI/CD
เครื่องมือที่เกี่ยวข้อง
ตัวสร้าง Meta Tags สำหรับ SEO
สร้างแท็ก Open Graph, Twitter Cards และ SEO Meta Tags สำหรับเว็บไซต์
ตัวสร้าง .gitignore
สร้างไฟล์ .gitignore มาตรฐานสำหรับภาษา โปรแกรมแก้ไข และเฟรมเวิร์กต่างๆ
ตัวสร้างสัญญาอนุญาตโอเพนซอร์ส
สร้างไฟล์ LICENSE โอเพนซอร์สมาตรฐาน (MIT, Apache 2.0, GPLv3, BSD, ISC)
ตัวสร้างไฟล์ README
สร้างโครงร่างเอกสาร README.md ระดับมืออาชีพสำหรับโปรเจกต์ GitHub พร้อมแบดจ์
ตัวสร้างข้อความ Conventional Commit
สร้างข้อความ Git commit ตามมาตรฐาน Conventional Commits (feat, fix, docs, refactor)
ตัวดูและทดสอบ OpenAPI / Swagger
เรนเดอร์เอกสารสเปก OpenAPI/Swagger (YAML/JSON) เป็นหน้าต่างเอกสารแบบโต้ตอบ
คำถามที่พบบ่อยและความเป็นส่วนตัว
ความแตกต่างสำคัญระหว่าง `^` (caret) และ `~` (tilde) คืออะไร?
`~1.2.3` จะอนุญาตเฉพาะเวอร์ชันระดับ PATCH เท่านั้น (ตรงกับช่วง `>=1.2.3 <1.3.0`) ในขณะที่ `^1.2.3` จะอนุญาตทั้งเวอร์ชันระดับ MINOR และ PATCH (ตรงกับช่วง `>=1.2.3 <2.0.0`)
เมทาดาทาการบิลด์ (เช่น `+build123`) มีผลต่อลำดับความสำคัญของเวอร์ชัน (version precedence) หรือไม่?
ไม่มีผล ตามข้อกำหนด SemVer ข้อที่ 10 เมทาดาทาการบิลด์มีไว้เพื่อให้ข้อมูลเท่านั้น และจะต้องถูกละเว้นเมื่อต้องเปรียบเทียบลำดับความสำคัญของเวอร์ชัน