YUUNJIEE.COM
til-semver.md
[_][□][✕]
📄til-semver.md×
blog/til-semver.md

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日常維護、修修補補

官方規範:Semantic Versioning 2.0.0

share
ONLINE·yuun@blog·v2.7.0