1. SVN是什麼?
SVN是Subversion的簡稱,是一個開放源代碼的版本控制系統,相較於RCS、CVS,它採用了分支管理系統,它的設計目標就是取代CVS。互聯網上很多版本控制服務已從CVS遷移到Subversion。
集中式管理的工作流程如下圖:
集中式代碼管理的核心是服務器,所有開發者在開始新一天的工作之前必須從服務器獲取代碼,然後開發,最後解決衝突,提交。所有的版本信息都放在服務器上。如果脫離了服務器,開發者基本上可以說是無法工作的。下面舉例說明:
開始新一天的工作:
1、從服務器下載項目組最新代碼。
2、進入自己的分支,進行工作,每隔一個小時向服務器自己的分支提交一次代碼(很多人都有這個習慣。因爲有時候自己對代碼改來改去,最後又想還原到前一個小時的版本,或者看看前一個小時自己修改了哪些代碼,就需要這樣做了)。
3、下班時間快到了,把自己的分支合併到服務器主分支上,一天的工作完成,並反映給服務器。
這就是經典的svn工作流程,從流程上看,有不少缺點,但也有優點。
2. SVN的三部分
SVN的工作機制在某種程度上就像一顆正在生長的樹:
- 一顆有樹幹和許多分支的樹
- 分支從樹幹生長出來,並且細的分支從相對較粗的樹幹中長出
- 一棵樹可以只有樹幹沒有分支(但是這種情況不會持續很久,隨着樹的成長,肯定會有分支啦,
- 一顆沒有樹幹但是有很多分支的樹看起來更像是地板上的一捆樹枝
- 如果樹幹患病了,最終分支也會受到影響,然後整棵樹就會死亡
- 如果分支患病了,你可以剪掉它,然後其他分支還會生長出來的哦!
- 如果分支生長太快了,對於樹幹它可能會非常沉重,最後整棵樹會垮塌掉
- 當你感覺你的樹、樹幹或者是分支看起來很漂亮的時候,你可以給它照張相,這樣就就可以記得它在那時是多麼的贊。
關於SVN有一個很形象的圖來展示,如下:
2.1 Trunk
Trunk是放置穩定代碼的主要環境,就好像一個汽車工廠,負責將成品的汽車零件組裝在一起。
以下內容將告訴你如何使用SVN trunk:
- 除非你必須處理一些容易且能迅速解決的BUG,或者你必須添加一些無關邏輯的文件(比如媒體文件:圖像,視頻,CSS等等),否則永遠 不要在trunk直接做開發
- 不要因爲特殊的需求而去對先前的版本做太大的改變,如何相關的情況都意味着需要建立一個branch(如下所述)
- 不要提交一些可能破壞trunk的內容,例如從branch合併
- 如果你在某些時候偶然間破壞了trunk,bring some cake the next day (”with great responsibilities come… huge cakes”)
2.2 Branches
在SVN中主幹代碼一般是放置在Trunk目錄下的,如果要新建Branch的話則放置在Branchs目錄下。(注意這是一種約定,SVN並不強制你這樣做)注意Branhs和Trunk目錄要平級,不能有嵌套,要不會引起混亂。
myproject/
trunk/
branches/
tags/
一個branch就是從一個SVN倉庫中的子樹所作的一份普通拷貝。通常情況它的工作類似與UNIX系統上的符號鏈接,但是你一旦在一個SVN branch裏修改了一些文件,並且這些被修改的文件從拷貝過來的源文件獨立發展,就不能這麼認爲了。當一個branch完成了,並且認爲它足夠穩定的時 候,它必須合併回它原來的拷貝的地方,也就是說:如果原來是從trunk中拷貝的,就應該回到trunk去,或者合併回它原來拷貝的父級branch。
以下內容將告訴你如何使用SVN branches:
- 如果你需要修改你的應用程序,或者爲它開發一個新的特性,請從trunk中創建一個新的branch,然後基於這個新的分支進行開發
- 除非是因爲必須從一個branch中創建一個新的子branch,否則新的branch必須從trunk創建
- 當你創建了一個新branch,你應當立即切換過去。如果你沒有這麼做,那你爲什麼要在最初的地方創建這個分支呢?
創建:創建一個Branch也相當簡單,只需要一條命令即可:
svn copy http://example.com/repos/myproject/trunk http://example.com/repos/myproject/branches/releaseForAug -m 'create branch for release on August'
合併:既然要創建分支也需要合併分支。基本的合併也是蠻簡單的。
假設現在Branch上fix了一系列的bug,現在我們想把針對Branch的改變同步到Trunk上,那麼應該怎麼做那?
-
保證當前Branch分支是clean的,也就是說使用svn status看不到任何的本地修改。
-
命令行下切換到Trunk目錄中,使用
svn merge http://example.com/repos/myproject/branches/releaseForAug
來將Branch分支上的改動merge回Trunk下。 -
如果出現merge衝突則進行解決,然後執行
svn ci -m 'description'
來提交變動。
當然在merge你也可以指定Branch上那些版本變更可以合併到Trunk中。
svn merge http://example.com/repos/myproject/branches/releaseForAug -r150:HEAD
示例中是將Branch的從版本150到當前版本的所有改動都合併到Trunk中。
你也可以將Trunk中的某些更新合併到Branch中,還是同樣的方法。
查看當前Branch和Trunk的合併情況
可以使用svn mergeinfo
來查看merge情況。
查看當前Branch中已經有那些改動已經被合併到Trunk中:
# cd to trunk directory
svn mergeinfo http://example.com/repos/myproject/branches/releaseForAug
查看Branch中那些改動還未合併。
#cd to trunk directory
svn merginfo http://example.com/repos/myproject/branches/releaseForAug --show-revs eligible
2.3 Tags
從表面上看,SVN branches和SVN tags沒有什麼差別,但是從概念上來說,它們有許多差別。其實一個SVN tags就是上文所述的“爲這棵樹照張相”:一個trunk或者一個branch修訂版的命名快照。
以下內容將告訴你如何使用SVN tags:
- 作爲一個開發者,永遠不要切換至、取出,或者向一個SVN tag提交任何內容:一個tag好比某種“照片”,並不是實實在在的東西,tags只可讀,不可寫。
- 在特殊或者需要特別注意的環境中,如:生產環境(production)、?(staging)、測試環境(testing)等等,只 能從一個修復過的(fixed)tag中checkout和update,永遠不要commit至一個tag。
- 對於上述提及到的環境,可以創建如下的tags:“production”,“staging”,“testing”等等。你也可以根 據軟件版本、項目的成熟程度來命名tag:“1.0.3”,“stable”,“latest”等等。
- 當trunk已經穩定,並且可以對外發布,也要相應地重新創建tags,然後再更新相關的環境(production, staging, etc)
工作流樣例:
假設你必須添加了一個特性至一個項目,且這個項目是受版本控制的,你差不多需要完成如下幾個步驟:
- 使用SVN checkout或者SVN switch從這個項目的trunk獲得一個新的工作拷貝(branch)
- 使用SVN切換至新的branch
- 完成新特性的開發(當然,要做足夠的測試,包括在開始編碼前)
- 一旦這個特性完成並且穩定(已提交),並經過你的同事們確認,切換至trunk
- 合併你的分支至你的工作拷貝(trunk),並且解決一系列的衝突
- 重新檢查合併後的代碼
- 如果可能的話,麻煩你的同事對你所編寫、更改的代碼進行一次複查(review)
- 提交合並後的工作拷貝至trunk
- 如果某些部署需要特殊的環境(生成環境等等),請更新相關的tag至你剛剛提交到trunk的修訂版本
- 使用SVN update部署至相關環境
3. 常用的SVN命令
1、將文件checkout到本地目錄
svn checkout path(path是服務器上的目錄)
例如:svn checkout svn://192.168.1.1/pro/domain
簡寫:svn co
2、往版本庫中添加新的文件
svn add file
例如:svn add test.php(添加test.php)
svn add *.php(添加當前目錄下所有的php文件)
3、將改動的文件提交到版本庫
svn commit -m “LogMessage“ [-N] [--no-unlock] PATH(如果選擇了保持鎖,就使用–no-unlock開關)
例如:svn commit -m “add test file for my test“ test.php
簡寫:svn ci
note: 在提交(ci)之前一定要先進行版本的更新,否則會覆蓋上一個提交(很可能在你開發過程中,你的同事已經進行了版本的更新)的版本!!!
ci的具體流程:
(1)進入修改的目錄下,查看修改的信息:
svn diff
svn info
(2)將版本更新到最新版本:
svn up
(3)提交修改後的版本:
svn ci -m "comment"
4、加鎖/解鎖
svn lock -m “LockMessage“ [--force] PATH
例如:svn lock -m “lock test file“ test.php
svn unlock PATH
5、更新到某個版本
svn update -r m path
例如:
svn update如果後面沒有目錄,默認將當前目錄以及子目錄下的所有文件都更新到最新版本。
svn update -r 200 test.php(將版本庫中的文件test.php還原到版本200)
svn update test.php(更新,於版本庫同步。如果在提交的時候提示過期的話,是因爲衝突,需要先update,修改文件,然後清除svn resolved,最後再提交commit)
簡寫:svn up
6、查看文件或者目錄狀態
1)svn status path(目錄下的文件和子目錄的狀態,正常狀態不顯示)
[?:不在svn的控制中;M:內容被修改;C:發生衝突;A:預定加入到版本庫;K:被鎖定]
2)svn status -v path(顯示文件和子目錄狀態)
第一列保持相同,第二列顯示工作版本號,第三和第四列顯示最後一次修改的版本號和修改人。
注:svn status、svn diff和 svn revert這三條命令在沒有網絡的情況下也可以執行的,原因是svn在本地的.svn中保留了本地版本的原始拷貝。
簡寫:svn st
7、刪除文件
svn delete path -m “delete test fle“
例如:svn delete svn://192.168.1.1/pro/domain/test.php -m “delete test file”
或者直接svn delete test.php 然後再svn ci -m ‘delete test file‘,推薦使用這種
簡寫:svn (del, remove, rm)
8、查看日誌
svn log path
例如:svn log test.php 顯示這個文件的所有修改記錄,及其版本號的變化
9、查看文件詳細信息
svn info path
例如:svn info test.php
10、比較差異
svn diff path(將修改的文件與基礎版本比較)
例如:svn diff test.php
svn diff -r m:n path(對版本m和版本n比較差異)
例如:svn diff -r 200:201 test.php
簡寫:svn di
11、將兩個版本之間的差異合併到當前文件
svn merge -r m:n path
例如:svn merge -r 200:205 test.php(將版本200與205之間的差異合併到當前文件,但是一般都會產生衝突,需要處理一下)
12、SVN 幫助
svn help
svn help ci
——————————————————————————
以上是常用命令,下面寫幾個不經常用的
——————————————————————————
13、版本庫下的文件和目錄列表
svn list path
顯示path目錄下的所有屬於版本庫的文件和目錄
簡寫:svn ls
14、創建納入版本控制下的新目錄
svn mkdir: 創建納入版本控制下的新目錄。
用法: 1、mkdir PATH…
2、mkdir URL…
創建版本控制的目錄。
1、每一個以工作副本 PATH 指定的目錄,都會創建在本地端,並且加入新增
調度,以待下一次的提交。
2、每個以URL指定的目錄,都會透過立即提交於倉庫中創建。
在這兩個情況下,所有的中間目錄都必須事先存在。
15、恢復本地修改
svn revert: 恢復原始未改變的工作副本文件 (恢復大部份的本地修改)。revert:
用法: revert PATH…
注意: 本子命令不會存取網絡,並且會解除衝突的狀況。但是它不會恢復被刪除的目錄。
16、代碼庫URL變更
svn switch (sw): 更新工作副本至不同的URL。
用法: 1、switch URL [PATH]
2、switch –relocate FROM TO [PATH...]
1、更新你的工作副本,映射到一個新的URL,其行爲跟“svn update”很像,也會將服務器上文件與本地文件合併。這是將工作副本對應到同一倉庫中某個分支或者標記的方法。
2、改寫工作副本的URL元數據,以反映單純的URL上的改變。當倉庫的根URL變動(比如方案名或是主機名稱變動),但是工作副本仍舊對映到同一倉庫的同一目錄時使用這個命令更新工作副本與倉庫的對應關係。
17、解決衝突
svn resolved: 移除工作副本的目錄或文件的“衝突”狀態。
用法: resolved PATH…
注意: 本子命令不會依語法來解決衝突或是移除衝突標記;它只是移除衝突的相關文件,然後讓 PATH 可以再次提交。
18、輸出指定文件或URL的內容。
svn cat 目標[@版本]…如果指定了版本,將從指定的版本開始查找。
svn cat -r PREV filename > filename (PREV 是上一版本,也可以寫具體版本號,這樣輸出結果是可以提交的)