TIL: 語意化版本號 (SemVer) 的規則
2026-05-28·2 min read·updated 2026-05-28·semverversioningdev-practice
版本號不是隨便取的,SemVer 有 MAJOR.MINOR.PATCH 規則,今天才搞清楚差別。
今天才搞清楚版本號不是隨便取的,有個通用規範叫 Semantic Versioning(SemVer),格式是 MAJOR.MINOR.PATCH。
三個數字的意思
- PATCH:修 bug、改錯字,功能沒變 →
1.6.0 → 1.6.1 - MINOR:新增功能,但不影響舊有功能 →
1.5.0 → 1.6.0 - MAJOR:破壞性更動,舊的東西可能壞掉 →
1.6.0 → 2.0.0
升 MINOR 時,PATCH 歸零;升 MAJOR 時,MINOR 和 PATCH 都歸零。
上次踩坑
我上次做了一次大規模 UI 重構,整個視覺風格打掉重練,照規則應該要從 2.x → 3.0.0,但因為當時還不熟悉規則,只從 2.3 → 2.4。
後續更新部落格時會慢慢跟著這個規範走。
個人專案的建議
| 版本 | 意義 |
|---|---|
v0.x.x | 開發初期,還不穩定,隨時可能大改 |
v1.0.0 | 正式上線,代表是個完整的產品 |
v1.x.0 | 每次有感的功能更新 |
v1.x.x | 日常維護、修修補補 |
share›