檢驗歷史

你的版本庫就像是一台時間機器,它記錄了所有提交的修改,允許你檢查文件或目錄以及相關Meta資料的歷史。通過一個Subversion命令你可以根據時間或修訂號取出一個過去的版本(或者恢復現在的工作副本),然而,有時候我們只是想看看歷史而不想回到歷史。

有許多命令可以為你提供版本庫歷史:

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
------------------------------------------------------------------------

注意日誌訊息預設根據時間逆序排列,如果希望察看特定順序的一段修訂版本或者單一版本,使用--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 catsvn 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
$

你可以重定向輸出到一個文件:

$ svn cat -r 2 rules.txt > rules.txt.v2
$

svn list

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等價物)。

獲得舊的版本庫快照

除了以上的命令,你可以使用帶參數--revisionsvn updatesvn 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 updatesvn 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
…


[8] 看到了吧?我們說過Subversion是一個時間機器。