from :
(本文 crossposting 於 alphacamp blog)
如果說有什麼是開發軟體專案一定要使用的基礎工具，使用「版本控制系統」應該可以記上一筆。無論是個人或是團隊開發，都可以透過版本控制系統獲得巨大的好處。
沒有版本控制系統的話，檔案可能被別人或自己不小心覆蓋或遺失、也不知道是誰因為什麼原因改了這段程式碼、也沒辦法可以復原回前幾天的修改。有了版本控制系統，開發人員只要將每次程式碼的變更都紀錄(commit)起來，並且透過版本控制系統中進行更新。
有了版本控制系統，我們可以瀏覽所有開發的歷史紀錄，掌握團隊的開發進度，而且作任何修改都不再害怕，因為你可以輕易的復原回之前正常的版本。我們也可以透過分支(branching)和標籤(tagging)的功能來進行軟體發行的不同版本，例如穩定版本、維護版本和開發中版本。
已經沒有什麼可以阻礙你使用版本控制系統，git 或 mercurial 是免費開源的版本系統系統、隨處可用的網路、便宜的雲端伺服器，甚至有現成的第三方服務 github 或 bitbucket。
如果你還沒有使用的話，建議馬上為你的軟體專案建立版本控制。接下來是幾點使用版本控制系統的建議：
是的，「所有」專案中的產出物(source artifact)都放到版本控制系統之中，這包括了程式原始碼、測試程式、檔案、設定檔、各種自動化指令碼等等。除了新成員可以很容易拉出最新的版本馬上開始工作之外，我們也希望在測試環境、正式環境中，也可以隨時更新到我們所指定的版本，因此將所有變更的紀錄儲存起來是非常重要的。
例如，資料庫綱要(schema)的變更也必須納入版本控制。首先，我們在資料庫中紀錄它目前的版本編號。接著我們每次的修改都透過乙個自動化指令碼來執行，並將這個指令碼放入版本控制之中，而不是手動用指令去修改綱要。這樣的好處是團隊中每個人都可以透過版本控制系統看到這個變更，並且公升級他的資料庫。測試和正式的伺服器環境，也會透過這個指令碼來自動進行公升級。筆者熟悉的 ruby on rails 中就有內建這樣的 migration 機制，其他程式語言也有類似的資料庫工具。
另外，以伺服器應用來說，光是有「程式原始碼」還是無法 100% 讓軟體正確地跑起來，我們還需要知道伺服器的配置設定，包括基礎網路設定、作業系統設定、依賴的套件版本等等。因此最好這些配置設定也可以納入版本管理系統之中。近年來雲端技術的進步，已經可以將這些基礎設施設定當作程式(infrastructure as code)，無縫地讓每個成員和所有環境都使用完全相同的設定，減少出錯的可能性。
如果久久才遞交(commit)一次修改到版本控制系統，那麼你只是把版本控制系統當作一種備份工具而已，而沒有享受到它真正的好處。頻繁的遞交可以幫助團隊開發進度的透明化，減少多人開發時的程式碼衝突。當多人同時修改同一塊程式碼時，解決程式碼衝突是很麻煩的事情。還有，我們也希望每一次的遞交有適當的粒度大小，也就是每個 commit 的內容應該有高度相關性和獨立性。例如是乙個小功能或是乙個小改進。如果你同時在做新功能a和修舊bug，那麼就應該分開兩次遞交。語法錯誤無法建構的程式也不應 commit 造成團隊困擾。
有良好大小的 commit 的好處除了版本的歷史紀錄更加清楚之外，我們可以非常輕易的做程式碼的復原或移植，假設上述的新功能a有問題，我們可以只復原a而不影響修好的bug，或是只挑選修bug的移植到不同分支去。
每一次的遞交我們都必須附上一段解釋訊息，說明修改的內容和原因。這除了可以幫助團隊合作之外，更重要的是讓軟體有更好的維護性，以便將來備查，以下的場景相信開發者都不陌生：
軟體發現乙個 bug，下班前指派給你修
你追 code 追到一段看不懂的程式，也沒有任何註解
透過版本控制系統，你找到了某 a 君在一年前加了這行，遞交的訊息是 fixed **** bug 或乙個單字 tweaks
a 君還在公司，可是他也不記得當初是哪乙個 ****。或是他已經下班或離職了，反正找不到
你硬改了這行 code，發布出去
這個功能是修好了，但是發現另乙個功能爛了
繼續加班到凌晨
乙個好的遞交訊息應該包括一行摘要訊息，描述你為什麼做這段變更，可能是新增、移除、修正某個功能，而不是描述新增或修改哪些檔案，重點應放在 why 而不是 what。因為修改了哪些檔案和行數我們看版本差異就知道了，無須重複描述。如果你發現很難摘要，那可能表示你包含太多變更在同一次遞交了，請試著拆開。
更多訊息細節可能包括 1. 為什麼這個修改是必要的？因為某種 workaround？ 2. 解決問題背後的原理是什麼？ 3. 影響的***是什麼？5. 專案管理系統(issue tracking system)的關聯票號等等
為什麼要使用版本控制系統？
在開發專案中使用版本控制系統有很多好處。本章節將向你介紹其中的一些細節。試想一下，如果沒有版本控制系統，當你需要處理那些共享資料夾中的檔案時，你必須告知辦公室裡的所有人，你正在對哪些檔案進行編輯 與此同時，其他人必須要避免與操作相同的檔案。這是乙個不現實和完全錯誤的流程。當你花了很長時間完成你的編輯...
版本控制系統的總結
版本控制系統 是指對各種 配置檔案及說明文件等檔案變更的管理工具。包括 檢入和檢出控制 分支和合併 歷史紀錄等。在我們日常工作中，經常會用到版本控制系統，尤其是在多人協作的專案中。下面就對我使用過的版本控制系統進行的總結。tfs是team foundation server tfs 的簡稱，是軟體專...
Git 分布式版本控制系統 三
一次commit就是乙個版本，在檔案修改過程中，我們會不斷commit檔案，因此git會記錄每次提交的版本號，因為git採用分布式，所以版本號不可能像svn似的數字標記，而採用sha來生成版本號。一旦檔案改亂了或者誤刪了檔案，就可以通過版本號來回退。可以通過 git log 來檢視版本提交日誌。首先...