ALL NOTES

LAB NOTES / 2026.10.18

開發筆記|TaskTimer 的身高尺,來聊聊「版本號」的命名邏輯

使用網站的時候,因為資料與程式碼都在伺服器端,重新整理網頁就能取得最新版本,所以在本地端不需要手動更新,很少會去留意到「版本號」的存在。

但手機 App 就完全不同了。大家應該都有經驗,手機常常會因為軟體不定時更新,跳出通知要求我們到 App Store 或 Google Play 下載最新版本。在自己開始進行開發、發佈 TaskTimer 之前,我對於版本號的印象大概也就僅限於此。

但在 TaskTimer 正式上線並進入實際使用的維護階段後,有時候根據自己在實際使用中察覺到的新需求去增加功能、有時候修補突然發現的小 Bug,這時就會面臨到 「我要如何標註這次更新」 的問題。

版本號有什麼規則?大家又是怎麼去更新的呢?


那幾段數字,分別代表什麼意思?

我們最常看到的版本號格式,通常長得像這樣:v1.2.3 或 2.0.1。這種規範在軟體開發中被稱為 語意化版本(Semantic Versioning,簡稱 SemVer)。

通常由三個主要數字組成,格式為 主版本號.次版本號.修訂號:

1
2
3
4
v 1 . 2 . 3
│ │ └─ 修訂號 (PATCH):修 Bug、小微調
│ └───── 次版本號 (MINOR):新增功能(向下相容)
└───────── 主版本號 (MAJOR):重大架構更新(可能不向下相容)

主版本號 (MAJOR):重大升級(第一個數字)

  • 變動時機:當軟體進行了 大規模的架構重構、介面大改版,或是做了無法向下相容(Breaking Changes)的重大變更時。

  • 舉例來說:整個 TaskTimer 的底層架構重寫,或是舊版的資料格式在新的版號下無法直接讀取,主版本號就會從 1.0.0 跨越到 2.0.0。

次版本號 (MINOR):功能新增(第二個數字)

  • 變動時機:當作品 加入了新功能,但這個功能完全不影響現有功能的使用(保持向下相容)。

  • 以 TaskTimer 為例:例如我在 TaskTimer 加入「匯出 CSV 紀錄」的新功能,原本的計時器依然能正常運作,這時版本號就可以從 1.0.0 推進到 1.1.0。

修訂號 (PATCH):錯誤修復與微調(第三個數字)

  • 變動時機:沒有新增大功能,只是 修復了小 Bug、調整文字、或是改善效能。

  • 以 TaskTimer 為例:如果發現某個按鈕在特定螢幕尺寸下跑版、或是不小心打了錯別字,修完之後版號就會從 1.0.0 變成 1.0.1。


從「看版本號」到「賦予版本號」

從單純的「使用者」變成「開發者」後,隨著維護 TaskTimer,每次在發佈前修改版本號數字時,都覺得好像在看自己的作品慢慢成長,類似小朋友的身高尺,不同階段在上面畫上一橫,等有一天回頭,可能就會覺得哇,已經長這麼高了呀!

所有筆記