你的版本庫就像是一台時間機器,它記錄了所有提交的修改,允許你檢查文件或目錄以及相關Meta資料的歷史。通過一個Subversion命令你可以根據時間或修訂號取出一個過去的版本(或者恢復現在的工作副本),然而,有時候我們只是想看看歷史而不想回到歷史。
有許多命令可以為你提供版本庫歷史:
展示給你主要訊息:每個版本附加在版本上的作者與日期訊息和所有路徑修改。
顯示特定修改的行級詳細訊息。
取得在特定版本的某一個文件顯示在當前屏幕。
顯示一個目錄在某一版本存在的文件。
找出一個文件或目錄的歷史訊息,使用svn log命令,svn log將會提供你一條記錄,包括:誰對文件或目錄作了修改、哪個修訂版本作了修改、修訂版本的日期和時間、還有如果你當時提供了日誌訊息,也會顯示。
$ svn log ------------------------------------------------------------------------ r3 | sally | Mon, 15 Jul 2002 18:03:46 -0500 | 1 line Added include lines and corrected # of cheese slices. ------------------------------------------------------------------------ r2 | harry | Mon, 15 Jul 2002 17:47:57 -0500 | 1 line Added main() methods. ------------------------------------------------------------------------ r1 | sally | Mon, 15 Jul 2002 17:40:08 -0500 | 1 line Initial import ------------------------------------------------------------------------
注意日誌訊息預設根據時間逆序排列,如果希望察看特定順序的一段修訂版本或者單一版本,使用--revision(-r) 選項:
$ svn log -r 5:19 # shows logs 5 through 19 in chronological order $ svn log -r 19:5 # shows logs 5 through 19 in reverse order $ svn log -r 8 # shows log for revision 8
你也可以檢查單個文件或目錄的日誌歷史,舉個例子:
$ svn log foo.c … $ svn log http://foo.com/svn/trunk/code/foo.c …
這樣只會顯示這個工作文件(或者URL)做過修訂的版本的日誌訊息。
如果你希望得到目錄和文件更多的訊息,你可以對svn log命令使用--verbose (-v)開關,因為Subversion允許移動和複製文件和目錄,所以追蹤路徑修改非常重要,在詳細模式下,svn log 輸出中會包括一個路徑修改的歷史:
$ svn log -r 8 -v ------------------------------------------------------------------------ r8 | sally | 2002-07-14 08:15:29 -0500 | 1 line Changed paths: M /trunk/code/foo.c M /trunk/code/bar.h A /trunk/code/doc/README Frozzled the sub-space winch. ------------------------------------------------------------------------
svn log也有一個--quiet (-q)選項,會禁止日誌訊息的主要部分,當與--verbose結合使用,僅會顯示修改的文件名。
我們已經看過svn diff—使用標準區別文件格式顯示區別,它在提交前用來顯示本地工作副本與版本庫的區別。
事實上,svn diff有三種不同的用法:
檢查本地修改
比較工作副本與版本庫
比較版本庫與版本庫
像我們看到的,不使用任何參數調用時,svn diff將會比較你的工作文件與快取在.svn的「原始」拷貝:
$ svn diff Index: rules.txt =================================================================== --- rules.txt (revision 3) +++ rules.txt (working copy) @@ -1,4 +1,5 @@ Be kind to others Freedom = Responsibility Everything in moderation -Chew with your mouth open +Chew with your mouth closed +Listen when others are speaking $
如果傳遞一個--revision(-r)參數,你的工作副本會與指定的版本比較。
$ svn diff -r 3 rules.txt Index: rules.txt =================================================================== --- rules.txt (revision 3) +++ rules.txt (working copy) @@ -1,4 +1,5 @@ Be kind to others Freedom = Responsibility Everything in moderation -Chew with your mouth open +Chew with your mouth closed +Listen when others are speaking $
如果通過--revision (-r)傳遞兩個通過冒號分開的版本號,這兩個版本會進行比較。
$ svn diff -r 2:3 rules.txt Index: rules.txt =================================================================== --- rules.txt (revision 2) +++ rules.txt (revision 3) @@ -1,4 +1,4 @@ Be kind to others -Freedom = Chocolate Ice Cream +Freedom = Responsibility Everything in moderation Chew with your mouth open $
與前一個修訂版本比較更方便的辦法是使用--change (-c):
$ svn diff -c 3 rules.txt Index: rules.txt =================================================================== --- rules.txt (revision 2) +++ rules.txt (revision 3) @@ -1,4 +1,4 @@ Be kind to others -Freedom = Chocolate Ice Cream +Freedom = Responsibility Everything in moderation Chew with your mouth open $
最後,即使你在本機沒有工作副本,還是可以比較版本庫的修訂版本,只需要在指令列中輸入合適的URL:
$ svn diff -c 5 http://svn.example.com/repos/example/trunk/text/rules.txt … $
通過svn cat和svn list,你可以在未修改工作修訂版本的情況下查看文件和目錄的內容,實際上,你甚至也不需要有一個工作副本。
如果你只是希望檢查一個過去的版本而不希望察看它們的區別,使用svn cat:
$ svn cat -r 2 rules.txt Be kind to others Freedom = Chocolate Ice Cream Everything in moderation Chew with your mouth open $
你可以重定向輸出到一個文件:
$ svn cat -r 2 rules.txt > rules.txt.v2 $
svn list可以在不下載文件到本地目錄的情況下來察看目錄中的文件:
$ svn list http://svn.collab.net/repos/svn README branches/ clients/ tags/ trunk/
如果你希望察看詳細訊息,你可以使用--verbose(-v) 參數:
$ svn list -v http://svn.collab.net/repos/svn 20620 harry 1084 Jul 13 2006 README 23339 harry Feb 04 01:40 branches/ 21282 sally Aug 27 09:41 developer-resources/ 23198 harry Jan 23 17:17 tags/ 23351 sally Feb 05 13:26 trunk/
這些列告訴你文件和目錄最後修改的修訂版本、做出修改的用戶、如果是文件還會有文件的大小,最後是修改日期和項目的名字。
沒有任何參數的svn list命令預設使用當前工作副本的版本庫URL,而不是本地工作副本的目錄。畢竟,如果你希望列出本地目錄,你只需要使用ls(或任何合理的非UNIX等價物)。
除了以上的命令,你可以使用帶參數--revision的svn update和svn checkout來使整個工作副本「回到過去」[8]:
$ svn checkout -r 1729 # Checks out a new working copy at r1729 … $ svn update -r 1729 # Updates an existing working copy to r1729 …
許多Subversion新手使用前面的svn update實例來「回退」修改,但是你不能提交修改,你獲得有新修訂版本的過時工作副本也是沒有用的。關於如何「回退」,我們可以看「找回刪除的項目」一節。
最後,如果你構建了一個版本,並且希望從Subversion打包文件,但是你不希望有討厭的.svn目錄,這時你可以導出版本庫的一部分文件而沒有.svn目錄。就像svn update和svn checkout,你也可以傳遞--revision選項給svn export:
$ svn export http://svn.example.com/svn/repos1 # Exports latest revision … $ svn export http://svn.example.com/svn/repos1 -r 1729 # Exports revision r1729 …