SVN使用log,list,cat,diff命令檢視特定檔案版本資訊
svn log 展示給你主要資訊:每個版本附加在版本上的作者與日期資訊和所有路徑修改。
svn diff 顯示特定修改的行級詳細資訊。
svn cat 取得在特定版本的某一個檔案顯示在當前螢幕。
svn list 顯示一個目錄在某一版本存在的檔案。
找出一個檔案或目錄的歷史資訊,使用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
------------------------------------------------------------------------
[/pre]注意日誌資訊預設根據時間逆序排列
$ 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
…
[/pre]這樣只會顯示這個工作檔案(或者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.
------------------------------------------------------------------------
[/pre]svn log
為什麼svn log給我一個空的迴應?
當使用Subversion一些時間後,許多使用者會遇到這種情況:
$ svn log -r 2
------------------------------------------------------------------------
$
[/pre]乍一看,好像是一個錯誤,但是想一下修訂版本號是作用在版本庫整體之上的,如果你沒有提供路徑,svn log會使用當前目錄作為預設的目標,所以,作為結果,如果你對一個本身和子目錄在指定版本到現在沒有做過修改的目錄執行這個命令,你會得到空的日誌。如果你希望察看某個版本做的修改的日誌,只需要直接告訴svn log使用版本庫頂級的目錄作為引數,例如。
檢查歷史修改的詳情
我們已經看過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
$
[/pre]比較工作拷貝和版本庫
如果傳遞一個--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
$
[/pre]比較版本庫與版本庫
如果通過--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
$
[/pre]與前一個修訂版本比較更方便的辦法是使用--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
$
[/pre]最後,即使你在本機沒有工作拷貝,還是可以比較版本庫的修訂版本,只需要在命令列中輸入合適的URL:
$ svn diff -c 5 http://svn.example.com/repos/example/trunk/text/rules.txt
…
$
[/pre]瀏覽版本庫
通過svn cat和svn list,你可以在未修改工作修訂版本的情況下檢視檔案和目錄的內容,實際上,你甚至也不需要有一個工作拷貝。
svn cat
如果你只是希望檢查一個過去的版本而不希望察看它們的區別,使用svn cat:
$ svn cat -r 2 rules.txt
Be kind to others
Freedom = Chocolate Ice Cream
Everything in moderation
Chew with your mouth open
$
[/pre]你可以重定向輸出到一個檔案:
$ svn cat -r 2 rules.txt > rules.txt.v2
$
[/pre] svn list
svn list可以在不下載檔案到本地目錄的情況下來察看目錄中的檔案:
$ svn list http://svn.collab.net/repos/svn
README
branches/
clients/
tags/
trunk/
[/pre]如果你希望察看詳細資訊,你可以使用--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/
[/pre]這些列告訴你檔案和目錄最後修改的修訂版本、做出修改的使用者、如果是檔案還會有檔案的大小,最後是修改日期和專案的名字。
警告
沒有任何引數的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
…
[/pre]提示
許多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
…
[/pre]