三個使用版本控制系統的建議

(本文 crossposting 於 ALPHACamp Blog)

如果說有什麼是開發軟體專案一定要使用的基礎工具,使用「版本控制系統」應該可以記上一筆。無論是個人或是團隊開發,都可以透過版本控制系統獲得巨大的好處。

沒有版本控制系統的話,檔案可能被別人或自己不小心覆蓋或遺失、也不知道是誰因為什麼原因改了這段程式碼、也沒辦法可以復原回前幾天的修改。有了版本控制系統,開發人員只要將每次程式碼的變更都紀錄(Commit)起來,並且透過版本控制系統中進行更新。

有了版本控制系統,我們可以瀏覽所有開發的歷史紀錄,掌握團隊的開發進度,而且作任何修改都不再害怕,因為你可以輕易的復原回之前正常的版本。我們也可以透過分支(Branching)和標籤(Tagging)的功能來進行軟體發行的不同版本,例如穩定版本、維護版本和開發中版本。

已經沒有什麼可以阻礙你使用版本控制系統,Git 或 Mercurial 是免費開源的版本系統系統、隨處可用的網路、便宜的雲端伺服器,甚至有現成的第三方服務 Github 或 Bitbucket。

如果你還沒有使用的話,建議馬上為你的軟體專案建立版本控制。接下來是幾點使用版本控制系統的建議:

1. 把所有東西都放進版本控制系統

是的,「所有」專案中的產出物(Source Artifact)都放到版本控制系統之中,這包括了程式原始碼、測試程式、文件、設定檔、各種自動化腳本等等。除了新成員可以很容易拉出最新的版本馬上開始工作之外,我們也希望在測試環境、正式環境中,也可以隨時更新到我們所指定的版本,因此將所有變更的紀錄保存起來是非常重要的。

例如,資料庫綱要(Schema)的變更也必須納入版本控制。首先,我們在資料庫中紀錄它目前的版本編號。接著我們每次的修改都透過一個自動化腳本來執行,並將這個腳本放入版本控制之中,而不是手動用指令去修改綱要。這樣的好處是團隊中每個人都可以透過版本控制系統看到這個變更,並且升級他的資料庫。測試和正式的伺服器環境,也會透過這個腳本來自動進行升級。筆者熟悉的 Ruby on Rails 中就有內建這樣的 Migration 機制,其他程式語言也有類似的資料庫工具。

另外,以伺服器應用來說,光是有「程式原始碼」還是無法 100% 讓軟體正確地跑起來,我們還需要知道伺服器的配置設定,包括基礎網路設定、作業系統設定、依賴的套件版本等等。因此最好這些配置設定也可以納入版本管理系統之中。近年來雲端技術的進步,已經可以將這些基礎設施設定當作程式(Infrastructure as Code),無縫地讓每個成員和所有環境都使用完全相同的設定,減少出錯的可能性。

2. 頻繁且適當大小的遞交

如果久久才遞交(Commit)一次修改到版本控制系統,那麼你只是把版本控制系統當作一種備份工具而已,而沒有享受到它真正的好處。頻繁的遞交可以幫助團隊開發進度的透明化,減少多人開發時的程式碼衝突。當多人同時修改同一塊程式碼時,解決程式碼衝突是很麻煩的事情。還有,我們也希望每一次的遞交有適當的粒度大小,也就是每個 Commit 的內容應該有高度相關性和獨立性。例如是一個小功能或是一個小改進。如果你同時在做新功能A和修舊Bug,那麼就應該分開兩次遞交。語法錯誤無法建構的程式也不應 Commit 造成團隊困擾。

有良好大小的 Commit 的好處除了版本的歷史紀錄更加清楚之外,我們可以非常輕易的做程式碼的復原或移植,假設上述的新功能A有問題,我們可以只復原A而不影響修好的Bug,或是只挑選修Bug的移植到不同分支去。

3. 良好的遞交訊息

每一次的遞交我們都必須附上一段解釋訊息,說明修改的內容和原因。這除了可以幫助團隊合作之外,更重要的是讓軟體有更好的維護性,以便將來備查,以下的場景相信開發者都不陌生:

  1. 軟體發現一個 Bug,下班前指派給你修
  2. 你追 Code 追到一段看不懂的程式,也沒有任何註解
  3. 透過版本控制系統,你找到了某 A 君在一年前加了這行,遞交的訊息是 Fixed shit bug 或一個單字 Tweaks
  4. A 君還在公司,可是他也不記得當初是哪一個 shit。或是他已經下班或離職了,反正找不到
  5. 你硬改了這行 code,發布出去
  6. 這個功能是修好了,但是發現另一個功能爛了
  7. 繼續加班到凌晨

一個好的遞交訊息應該包括一行摘要訊息,描述你為什麼做這段變更,可能是新增、移除、修正某個功能,而不是描述新增或修改哪些檔案,重點應放在 Why 而不是 What。因為修改了哪些檔案和行數我們看版本差異就知道了,無須重複描述。如果你發現很難摘要,那可能表示你包含太多變更在同一次遞交了,請試著拆開。

更多訊息細節可能包括 1. 為什麼這個修改是必要的?因為某種 Workaround? 2. 解決問題背後的原理是什麼? 3. 影響的副作用是什麼?5. 專案管理系統(Issue Tracking System)的關聯票號等等

補充: How to write the perfect pull request

參與討論

1 則留言

發佈留言

發表迴響