說來有點不好意思,做開發這麼久一直沒真正用過 SVN。身邊的人都在用,學生時代也翻過教學,但後來在公司的環境裡長期單打獨鬥,也就一直擱著。直到最近團隊協作需要,才把它認真跑了一遍。下面就把整個學習過程整理成一份可操作的筆記。
SVN 本質上就是一個版本控制工具。運作原理很單純:架一台 SVN 伺服器集中管理程式碼,開發者從伺服器取得程式碼、提交變更、更新到最新版本。
同事給了一個 SVN 位址與一組帳號密碼。第一件事就是把上面的原始碼下載到本地。開啟 terminal,先切換到要存放的目錄,這裡放在桌面:

cd ~/Desktop svn checkout <svnURL>
checkout 不指定目標目錄時,會以伺服器上的專案名稱建立一個資料夾下載到當前路徑。

看到下載進度跑完、桌面出現 ios_dm 資料夾,就代表成功了。
抓下來的目錄裡通常是空的(只有 trunk / branches / tags 之類的骨架),因為我的專案一直躺在本地、從沒進過版控。要把它納入管理,步驟是:
# 1. 把專案複製到 ios_dm/trunk 底下 # 2. 把這些檔案加入本地版本庫 svn add *
接著會看到大量 A 開頭的輸出,代表這些檔案已被標記為待新增。此時可以提交了:
svn commit -m "首次提交:匯入專案初始版本"

提交成功後,命令列會印出新的修訂版號碼。

到這裡,專案已經進到伺服器,之後任何機器都能直接 checkout 下來。
因為專案不只我一個人在動,同事也陸續提交了東西,所以每天開始寫之前先更新:

cd ios_dm/trunk svn update

更新到最新版本後再開始一天的工作,能大幅降低後面合併的痛苦。
寫完當天的功能,收工前提交。但有時候會看到這樣的錯誤:

看到 out of date 就要警覺:本地版本落後於伺服器——在你按下 commit 之前,已經有人提交過了。解法是/update 一次,把別人的變更先拉下來合併,再重新提交。
然而 update 過程也可能出現真正的衝突:

衝突的成因很具體:多個人修改了同一個檔案的同一個位置,SVN 無法判斷該保留誰的內容。此時它會列出選項讓你決定:
Select: (p) postpone, (df) diff-full, (e) edit,
(mc) mine-conflict, (tc) theirs-conflict,
(s) show all options:
各選項的意義:mc 用本地版本覆蓋伺服器版本;tc 用伺服器版本覆蓋本地版本;p 把兩邊內容都留下來交給你手動處理;df 只顯示差異供參考。
先按 df 看看差在哪:

差異的標記規則是:<<<<<<< .mine 到 ======= 之間是本地內容;======= 到 >>>>>>>> .r5 之間是伺服器內容(.r5 表示對方基於第 5 版)。
選擇 p 之後,該檔案旁會多出三個衍生檔案:

分別是:你自己的修改版本、共同祖先的原始版本、以及伺服器最新版本。打開衝突檔案會看到與剛才 diff 一樣的標記:

接下來就是人工智慧的部分了——手動把程式碼整理成正確的最終樣貌:

改完之後,要告訴 SVN「這個衝突我處理完了」:
svn resolved <衝突檔案路徑>

然後就能正常提交了。

提交過程中電腦突然當機,重開之後出現了異常狀態:

這是因為上次操作被中斷,留下了衝突處理的殘留檔案。先把殘留清乾淨才能繼續:

用 log 查修訂歷史:
svn log svn log -l 10 # 只看最近 10 筆

需要切換到舊版本時:
svn update -r 4 # 切到第 4 版

如果不小心刪錯檔案,或想把某個檔案還原成未修改的狀態:
svn revert <檔案名稱> svn revert -R . # 還原整個目錄
隨時用 svn status 確認工作副本的狀態,輸出左側的字母意義如下:
(空白) 未修改 A 已加入本地版本庫,待提交 C 存在衝突 D 已刪除 I 被忽略 M 已修改 R 已替換 X 由外部定義建立的版本化目錄 ? 檔案尚未納入版本庫 ! 檔案遺失或不完整(非透過 svn 刪除) ~ 受控檔案被同名的其他檔案阻擋
養成隨時 svn status 的習慣,能在提交前發現「怎麼多了一堆 ?」或「怎麼有檔案變 !」這類問題。
任何指令忘記怎麼用,svn help 都是最快的答案:svn help commit、svn help merge 會列出該子命令的所有參數與說明。與其硬背指令,不如把 help 用熟。