SubversionSubversion版本控制系統基本用法版本控制系統基本用法

製作：蔡煥麟日期： Jul-1-2010

納入 版本控制的檔案是集中放在伺服器端的檔案庫中，納入 版本控制的檔案是集中放在伺服器端的檔案庫中，我們需要先把檔案從檔案庫我們需要先把檔案從檔案庫取出取出（（ check outcheck out ），放到自），放到自己本機的目錄下，然後對這些本機的檔案異動。己本機的目錄下，然後對這些本機的檔案異動。異動之後的檔案要送回檔案庫，此動作稱為異動之後的檔案要送回檔案庫，此動作稱為送交送交（（ commitcommit ）。）。

伺服器端

用戶端

用戶端

3

用戶端需要安裝的軟體：用戶端需要安裝的軟體：TortoiseSVNTortoiseSVN 請到 請到 http://tortoisesvn.net/downloads 下載。下載。

此工具常有新版，並會自動提示，建議盡量此工具常有新版，並會自動提示，建議盡量更新至最新的版本。更新至最新的版本。

4

安裝 安裝 TortoiseSVNTortoiseSVN 執行執行 TortoiseSVN-1.3.3.6219-svn-1.3.1.msiTortoiseSVN-1.3.3.6219-svn-1.3.1.msi ，安裝完畢後重開機。，安裝完畢後重開機。

5

第一次取出專案（只須做一次）第一次取出專案（只須做一次） 在你本機硬碟上建立一個資料夾，例如：在你本機硬碟上建立一個資料夾，例如：

D:\EcampusD:\Ecampus 。。 開啟檔案總管，在 開啟檔案總管，在 D:\Ecampus D:\Ecampus 上面點右上面點右

鍵，選 鍵，選 SVN Checkout...SVN Checkout...

6

輸入檔案庫輸入檔案庫 URL: URL: http://163.14.18.229:8080/svn/eCampushttp://163.14.18.229:8080/svn/eCampus

輸入帳號密碼

按 OK

注意大小寫 !!

7

取出之後取出之後…… .. 資料夾和檔案圖示會有修改狀態資料夾和檔案圖示會有修改狀態

注意絕對不要刪除隱藏資料夾： 注意絕對不要刪除隱藏資料夾： .svn.svn 注意絕對不要把取出來的某個子資料夾整個注意絕對不要把取出來的某個子資料夾整個

複製成另一個新的資料夾，並對該資料夾內複製成另一個新的資料夾，並對該資料夾內的檔案修改。因為這會連隱藏的 的檔案修改。因為這會連隱藏的 .svn .svn 版版本控制檔也一併複製過來，你等於是在改同本控制檔也一併複製過來，你等於是在改同一份工作複本！一份工作複本！

更新本機的檔案更新本機的檔案 :: SVNSVN UpdateUpdate 使用時機：別人有送交新版檔案，你可以利使用時機：別人有送交新版檔案，你可以利

用 用 SVN Update SVN Update 將自己本機上的檔案更新將自己本機上的檔案更新至最新版本。至最新版本。

8

注意：如果你要更新的檔案在檔案庫上有新版，但你在自己機器上也有修改這個檔案，就會發生更新衝突的情形，此時在你的機器上會產生兩個版本的檔案供你比對。

9

檔案修改完之後，執行 檔案修改完之後，執行 CommitCommit

你可以對某個資料夾或特定檔案點右鍵，選 SVN Commit 。注意送交時應輸入這次改了什麼，或者原始的需求單號。同時注意下方要勾選欲送交的檔案。

10

執行 執行 Commit Commit 時，若檔案已先被別時，若檔案已先被別人改過人改過 TSVN TSVN 會顯示 會顯示 commit commit 失敗的訊息，並告失敗的訊息，並告

知檔案已經過期（知檔案已經過期（ out-of-dateout-of-date ）。）。

此時可以：此時可以： 執行 執行 SVN updateSVN update （更新），已（更新），已

11

放棄目前工作複本的修改放棄目前工作複本的修改 檔案或資料夾上點右鍵 檔案或資料夾上點右鍵 TortoiseSVN TortoiseSVN

Revert Revert 。這樣會將檔案回覆成檔案庫中。這樣會將檔案回覆成檔案庫中存放的版本。存放的版本。

12

更改檔名和目錄名更改檔名和目錄名 在檔案或目錄名稱上點右鍵 在檔案或目錄名稱上點右鍵

TortoiseSVN TortoiseSVN Rename Rename 。。 改檔名實際上是刪除原有檔案，再新增一個改檔名實際上是刪除原有檔案，再新增一個

檔案。檔案。 注意：改檔名時不允許只有大小寫的差異（注意：改檔名時不允許只有大小寫的差異（

這是因為這是因為 WindowsWindows 作業系統檔名大小寫不作業系統檔名大小寫不分的緣故。也就是說，如果你修改檔名時只分的緣故。也就是說，如果你修改檔名時只是變更字母的大小寫，這樣會出錯！是變更字母的大小寫，這樣會出錯！

如何刪除檔案如何刪除檔案1.1. 檔名上點右鍵 檔名上點右鍵 > TortoiseSVN> TortoiseSVN >> DeleteDelete

（也可以直接用檔案總管刪除掉）（也可以直接用檔案總管刪除掉）2.2. 在該檔案所屬的資料夾上點右鍵 在該檔案所屬的資料夾上點右鍵 > SVN > SVN

CommitCommit 。。

13

Review Review 關鍵術語關鍵術語 Repository: Repository: 共享的檔案儲存庫。共享的檔案儲存庫。 Check out: Check out: 第一次從檔案庫取出檔案。第一次從檔案庫取出檔案。 Update: Update: 從檔案庫拉新版本到本機。從檔案庫拉新版本到本機。 Commit: Commit: 檔案改完之後，傳送至檔案庫。檔案改完之後，傳送至檔案庫。 Revert: Revert: 撤銷自己本機的變動，恢復成檔案撤銷自己本機的變動，恢復成檔案

庫目前的版本。庫目前的版本。

14

提醒事項提醒事項 不要刪除 不要刪除 .svn.svn 隱藏目錄隱藏目錄 絕對不要把一個有加入版本控制的資料夾 絕對不要把一個有加入版本控制的資料夾

A A 複製成 複製成 BB ，然後修改 ，然後修改 B B 中的檔案 中的檔案 你修改的其實仍是 你修改的其實仍是 A A 的檔案的檔案 !!!!

檔名的大小寫最好在第一次命名時就決定好檔名的大小寫最好在第一次命名時就決定好。未來若要變動大小寫，請以「先刪除，後。未來若要變動大小寫，請以「先刪除，後加入」的方式處理。加入」的方式處理。

電子化校園系統的檔案庫有限制在 電子化校園系統的檔案庫有限制在 commit commit 時必須輸入送交訊息（時必須輸入送交訊息（ messagemessage）。）。

15