點選[Merge Changes In Merge Tool]鈕，會出現以下畫面，左上角代表伺服器端版本，右上角是本機端版本，下方則是編輯窗格，是您解決衝突後的結果，TFS會嘗試自動合併，如兩個版本雖然修改同一檔案，但是不同列，自動合併的結果會顯示在編輯窗格；若不幸兩個版本異動在同一列，則必須由讀者自行決定最終結果，您可以使用下方[Previous Change]、[Next Change]鈕來移動各個程式碼有異動的地方，若所有衝突皆已解決，[OK]鈕會Enable。

圖11 Merge Tool視窗

4.4 簽入程式碼

時機：程式已完成實作，並完成相關程式碼檢查，如命名規則，以及單元測試。

說明：透過這個步驟，您可以將完成的程式碼置入TFS程式碼管控系統。檔案從程式碼管控系統取出後，在Solution Explorer裡會顯示鎖頭標記，並且這些檔案會是唯讀的。

步驟：

• 執行上一步驟”取得最新程式碼”。
• 在"Pending Changes"視窗，檢查是否有檔案是您不小心改到的或只是用於測試的修改，您可以選擇它們按右鍵選”Undo”，以回復到程式碼管控系統裡的最新版本。
• 編譯程式，確認程式可正常編譯。
• 在"Pending Changes"視窗，勾選所有該簽入的檔案，基本上除了web.config，及一些您很確認是因為本機測試環境差異所引起的修改，其他檔案請一律勾選，不管是不是您親自改過，因為一些控制檔修改，如.sln、.csproj、.vbproj，是由Visual Studio引發的，但它們仍需要簽入(Check In)。

圖12 勾選須簽入(Check In)檔案

• 連結對應的Work Item，表示本次Check In是為了那一項工作而做。先選[Work Items]鈕，勾選對應Work Item，Check-in Action請選”Associate”選項，最後按[Check In]鈕。

圖13 連結Work Item

5 執行擱置(Shelve)步驟

時機： 當您的程式碼完成一半，想要請其他專案成員幫忙偵錯或檢視、或想要在正式簽入(Check In)程式碼管控系統前，備份程式碼，以防萬一。

說明：執行此步驟不會干擾到程式碼管控系統裡的程式碼。

步驟：

• 在Pending Changes視窗，勾選您欲擱置(Shelve)的檔案，然後按[Shelve]鈕。

圖14 進行擱置(Shelve)動作

• 輸入Shelveset名稱，筆者建議以模組名稱加入日期來命名，如”Module1 100302”，然後按[Shelve]鈕，到此完成擱置(Shelve)動作。

圖15 輸入Shelveset Name

• 輸入這個Shelveset擁有者帳號，再按[Find]鈕，會列出此帳號相關的Shelveset，若您要取得所有人的Shelveset，可輸入”*”。選擇您要的Shelveset後按[Unshelve]鈕。

圖16 進行Unshelve動作

6 執行分支(Branch)步驟

時機：需要一個系統多個版本同時發展時，如版本1.0已經上線了，但我們需要向前發展版本2.0，且同時需要維護版本1.0。

說明：執行分支(Branch)步驟後會在程式碼管控系統複製一份到另外一個目錄，之後兩個目錄彼此獨立，程式碼管控不會互相干擾，但後續可以執行合併(Merge)動作將其中一版本差異部份分享給另一版本。例如版本1.0修正了一些Bug，版本2.0是以版本1.0為基底分支出來的，所以這些Bug一定也存在於版本2.0，透過合併(Merge)功能可以回饋修正程式給版本2.0。

步驟：

• 在Souce Control Explorer，對您欲執行Branch的目錄按右鍵選”Branching and Merging” -> “Branch”。
• 輸入Branch後的目錄名稱，建議名稱可以是系統名稱加上新版本編號，如”DemoVersionControl20”：

圖17 輸入Branch後的目錄名稱

• 輸入新Branch之本機對應目錄，完成後按[Map]鈕：

圖18 輸入新Branch之本機對應目錄

它會以遞廻方式將欲分支(Branch)目錄下所有檔案進行複製動作，所有新複製的目錄與檔案皆會出現在Pending Changes視窗，此時這些檔案尚未完成分支 (Branch)動作。若確認無誤，請按[Check In]鈕簽入(Check In)所有分支(Branch)異動。

圖19 所有新複製的目錄與檔案會出現在Pending Changes視窗

• 簽入後在Source Control Explorer視窗會出現兩個目錄有分支(Branch)標示。

圖20 目錄有Branch標示

在Source Control Explorer選擇某一分支(Branch)目錄，按右鍵選”Branching and Merging” -> “View Hierarchy”，會顯示各分支(Branch)的階層關係，若您的系統已經超過三個以上分支(Branch)，這張圖可以讓您明瞭各個分支(Branch)的來龍去脈。

圖21 View Hierarchy

7 執行合併(Merge)步驟

時機：執行過分支(Branch)後，兩個分支(Branch)目錄已各自發展一段時間，例如有一些Bug修正，我們想要將這些修正同步更新至另一個分支(Branch)目錄。

說明：執行Branch步驟後會在程式碼管控系統複製一份到另外一個目錄，之後兩個目錄彼此獨立，程式碼管控不會互相干擾，但後續可以執行Merge動作將其中一版本差異部份分享給另一版本。例如版本1.0修正了一些Bug，版本2.0是以版本1.0為基底，所以這些Bug一定也存在於版本2.0，透過Merge功能可以回饋修正程式給版本2.0。

步驟：

• 在Souce Control Explorer，對您欲執行Merge的目錄按右鍵選”Branching and Merging” -> “Merge”，會出現以下畫面，預設Target branch為您所選擇的目錄，Source branch預設為其關聯的分支(Branch)目錄，如父階分支(Branch)目錄。

圖22 輸入來源、目的分支(Branch)目錄

• 選擇Version type如下表，請選”Latest Date”：

表2 Version type選項

圖23 選擇Version type

• 在Pending Changes視窗會因合併(Merge)而異動的檔案，按[Check In]鈕以完成最後的確認動作。

8 執行標籤(Label)步驟

時機：當您的系統已經發展到一個里程碑，如程式已實作完畢，並完成單元測試，準備進入整合測試階段時。

說明：透過標籤(Label)來標註Changeset，因為Changeset只是一組流水編號，不具可讀性，透過標籤(Label)您可以使用有意義的名稱加以標示，如Beta1、Beta2，Version1.0等，後續我們可以透過標籤(Label)取得特定版本進行相關測試。

步驟：

• 執行標籤(Label)前首先確認所有Pending Changes都已簽入。
• 在Source Control Explorer裡，對欲標註Label的目錄按右鍵選”Apply Label”，並輸入Label名稱，建議名稱為專案里程碑名稱或階段名稱，如Beta1，預設”Version”欄位為”Latest Version”，再按[Create]鈕，到此便完成Label標註。

圖24 輸入Label名稱

• 接下來我們要透過標籤(Label)取出程式碼，在Solution Explorer，對根節點按右鍵選”Get Specific Version”，接著在Version Type欄位選”Label”，再按右邊按鈕進行查詢。

圖25 依標籤(Label)取指定版本

• 按[Find]進行查詢，Find options可讓您輸入一些條件進行過濾。找到您要的Label，選擇後按[Ok]鈕。

圖26 Find Label

• 在Label欄位會出現查詢結果，最後按[Get]鈕以取得指定程式碼。

圖27 按[Get]鈕以取得指定程式碼

9 疑難排解

9.1 如何變更本機端程式碼管控目錄？

說明：本機端程式碼管控目錄是由Workspace來管理，所以當您的本機端程式碼目錄想要重整，如C糟硬碟空間不夠，想移至D糟，就必須變更您的Workspace對應關係。

步驟：

• 在Source Control Explorer裡，下拉選擇右上角”Workspace”欄位，選擇”Workspaces..”，再按[Edit]鈕。

圖28 管理Workspaces畫面

• 在編輯Workspace畫面裡，下方之Working folders窗格區域有：”Source Control Folder”為程式碼管控系統之目錄；”Local Folder”為本機端對應目錄，按右方按鈕進行變更，完成後請按[OK]鈕。

圖29 變更本機端目錄

• 詢問是否重新從程式碼管控系統取得一份最新程式碼置於新目錄，請按[是(Y)]鈕，如此即開始取得最新程式碼，完成後之前的舊目錄並不會自動清除，您仍須自行手動刪除。

圖30 詢問是否重新從程式碼管控系統取得一份取新程式碼置於新目錄

9.2 如何將某一檔案回復至上一版本？

說明：有時某個已簽入的程式碼異動(Changeset)經過測試發現有問題，此時需要回復上一個穩定的版本，再進行後續的測試或修改。雖然我們透過”Get Specific Version”暫時取得舊版本，但是無法強制要求所有專案成員直接回復舊版本。透過本步驟可以達成永久回復舊版本的效果。

步驟：

• 在Solution Explorer，對欲回復上一版本的檔案按右鍵選”View History”，查詢此檔案所有的簽入紀錄，如下圖：

圖31 View History

• 假設我們要回復的上一版本是Changeset 8，而最新版本是Changeset 11，回到Solution Explorer，對欲回復上一版本的檔案按右鍵選”Get Specific Version”，輸入”Changeset”欄位，如”8”，按[Get]鈕。

圖32 取得舊版本

• 在Solution Explorer裡，對此檔案按右鍵選”Check Out for Edit”，再按[Check Out]鈕，此時此檔案會標示成修改中。

圖33 Check Out檔案

• 在Solution Explorer裡，對此檔案按右鍵選”Check In”。

圖34 進行Check In動作

• 此時一定會發生衝突，請直接按[確定]鈕。

圖35 發生衝突

• 在Pending Changes視窗裡，按[Keep Local Version]鈕，意思是以目前本機端版本覆蓋掉伺服器端版本，接著要[Check In]鈕。

圖36 以目前本機端版本覆蓋掉伺服器端版本

• 完成後再以View History查詢，會多出一個新的Changeset，它的內容會與上上一個Changeset相同，如此即達成我們要的版本回復效果。

圖37 再以View History查詢

9.3 程式碼管控進入離線狀態後如何回復？

說明：當碰到網路斷線時，我們仍然可以開啟Visual Studio進行程式編輯與執行，不過後續再連上TFS，Visual Studio並不會自動回復連線狀態，並將離線期間的異動更新回TFS。

步驟：

• 當您的機器與TFS斷了網路連線時，開啟Visual Studio會出現以下畫面：

圖38 Visual Studio無法連上TFS之訊息

• 接下來會詢問您是否要進入離線模式(Offline)，請按[確定]鈕。

圖39 詢問您是否要進入離線模式

• 在Solution Explorer裡，您可以發現關於程式碼管控相關標誌都不見了，如鎖頭，勾勾等。此時您仍可以進行程式碼編輯與編譯等功能。

圖40 離線模式

• 待與TFS連線回復後，記得要重新開啟Visual Studio，在Solution Explorer裡，對根節點按右鍵選”Go Online”，會出現以下視窗，列出離線期間所有異動的檔案，可能會包含許多執行檔(.exe)、函式庫(.dll)等，您僅需要勾選您確實有異動的檔案即可，執行檔、函式庫請略過，然後按[Go Online]鈕。

圖41 選擇已變更的檔案，然後按[Go Online]鈕

• 回復線上(Online)模式成功後，程式碼管控相關標誌都回來啦，如下圖。後續即可進行簽入(Check In)動作。

圖42 回復至線上(Online)模式

9.4 如何檢視程式碼異動情形？

說明：檢視程式碼異動紀錄、分支(Branch)紀錄，同一檔案裡每一區段之異動人員與相應Work Item，從Work Item查詢相關程式碼異動。

步驟：

• 在Solution Explorer裡，對欲查詢的檔案按右鍵選”View History”，會顯示所有的Changeset清單，您可以任選兩者進行比較，按[Ctrl]鈕進行選擇，再按右鍵選[Compare]。

圖43 View History

• 差異視窗會分成兩邊，上方列出其所屬Changeset編號，內容差異的部份會成不同顏色標示：綠色代表新增內容；藍色代表修改內容；紅色代表刪除內容。

圖44 差異視窗

• 若您想要查詢某一Changeset實際異動內容，在Visual History視窗，選擇欲查詢之Changeset，按右鍵選”Changeset Details”，即可查到此Changeset所有異動檔案清單。若選擇某一檔案，按右鍵選”Compare” -> “With Previous Version”，即可查詢此檔案之異動內容。

圖45 查詢相關異動檔案

• 點選[Work Items]鈕，可查詢相關Work Item。

圖46 查詢相關Work Item

• 回到View History視窗，若您要查詢相關分支(Branch)紀錄，選擇某一Changeset，按[Track Change]鈕，會列出所有相關的Branch清單，請都勾選起來，再按[Visualize]鈕。

圖47 選擇Branch

• 會發現此Changeset目前只有套用於”DemoVersionControl”這個Branch(DemoVersionControl方塊裡有Changeset編號且底色是比較深的)，而沒有在”DemoVersionControl20”分支，若您想把這個Changeset合併至”DemoVersionControl20”，可直接從”DemoVersionControl”拖曳至”DemoVersionControl20”，即會出現合併(Merge)精靈。

圖48 Tracking Changeset

圖49 合併(Merge)精靈

• 若您要查詢同一檔案裡每一區段之異動人員與相應Work Item，請開啟欲查詢的檔案內容，對任一處按右鍵選”Source Control” -> “Annotation”，會顯示一個唯讀視窗，右半邊是程式碼內容；左半邊是每一區段最後異動的Changeset編號、修改人員、修改日期，對Changeset連結處點選即可進一步查詢Changeset細節。

圖50 Annotated畫面

• 若Changeset有連結到Work Item的話還可以查詢到對應的Work Item，以了解修改此段程式碼是為了什麼目的。

圖51 從Changeset查詢Work Item

• 從Work Item也能查詢相關程式碼異動，切換至Team Explorer，點選您的Team Project -> Work Items -> Team Querys -> 任一查詢，開啟某一Work Item，再切換至”All Links”頁。

圖52 Work Item查詢

圖53 Work Item之”All Links”頁

10 結語

程式碼管控系統相關功能滿多的，且相當複雜，對於初學者需要一些時間練習才能熟悉，對於專案經理而言，落實版本管控流程是很重要的，不然很容易流於形式，變成一個垃圾堆就可惜了。