使用標籤在 Azure Repos 中擷取檔案的快照集
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） 標籤可讓您擷取檔案的快照集。 稍後，您可以參考該快照集。 藉由使用您的標籤，您可以檢視、建置或甚至將一組大型檔案復原到套用標籤時的狀態。
必要條件
- 若要套用標籤，您必須將 [ 卷標 ] 權限設定為 [ 允許]。
- 若要尋找、列出或檢視卷標，您必須將 [讀取 ] 權限設定為 [允許]。
- 若要修改或刪除標籤，您必須擁有標籤，或將 [管理員][標籤] 權限設定為 [允許]。
使用標籤
在許多軟體專案中，當程式代碼達到合理的品質和穩定性層級時，小組會建置並發行新版本的產品。 小組必須標記每個檔案的目前版本。 即使檔案繼續變更，小組仍然可以取得並建置其專案中每個檔案的新版本。
理論上，您可以手動記錄每個檔案之每個變更集的標識符。 但這種過程並不實用。 TFVC 可讓作業變得簡單。 將標籤套用至包含檔案的資料夾、分支或專案。 您可以為標籤提供遵循您偏好之命名慣例的名稱。 卷標名稱的一些範例包括：「短期衝刺 5」、「M1」、「Beta2」和「候選版 0」。
套用標籤之後，即可使用它來限定建置、分支、合併、比較和取得特定檔案和資料夾版本等作業。
有時候在套用標籤之後，您決定需要變更標籤。 TFVC 可讓您將標籤套用至其他檔案、從特定檔案中移除標籤，以及修改標籤適用的特定檔案版本。
提示
套用標籤可提供許多與建立分支相同的優點，但通常成本較低且複雜度較低。 取捨是，對於大型資料庫而言，合併之類的作業在針對標籤執行時可能需要更長的時間。
套用標籤
注意
當您使用 Visual Studio 來套用已經存在的標籤時，此作業會從所有檔案版本移除標籤，然後套用標籤。 不過，從命令提示字元中，標籤作業是加總的。 請參閱 Label 命令 （Team Foundation 版本控制）。
在 Visual Studio 的 [檢視] 功能表上，選取 [其他 Windows>原始檔控制總管]。
在 [原始檔控制總管] 中，以滑鼠右鍵按下您要套用標籤的集合、專案、分支、資料夾或檔案，然後選取 [進階>套用卷標]。 [ 新增標籤 ] 對話框隨即出現。
在 [ 名稱] 方塊中，輸入標籤名稱。
（選擇性）在 [ 批注] 方塊 中，輸入批注。
在 [ 版本] 清單中， 預設會選取 [最新版本 ]。 此選項是最常使用的選項。 如果您需要標籤以特定版本為目標，請選取下列其中一個選項：
Changeset：在 [變更集] 方塊中 指定變更集 的數目。 或者，選取省略號 （...） 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊，請參閱 尋找和檢視變更集。
日期：在 [日期] 方塊中指定日期，或從下拉菜單的行事曆中選取日期。
標籤：指定要根據新標籤的現有標籤。 在 [卷標] 方塊中輸入標籤名稱，或選取省略號 （...） 以開啟 [尋找卷標] 對話框。 如需詳細資訊，請參閱 尋找、編輯和移除標籤。
工作區版本：在工作區中建立版本的標籤。
當您滿意您的設定時，請採取下列步驟之一：
若要套用標籤，請選取 [ 建立]。
若要套用標籤，然後在套用標籤之後加以修改，請選取 [建立] 和 [ 編輯]。 此動作會套用標籤，然後顯示 [ 卷標 ] 視窗。 如需使用標籤視窗編輯標籤的詳細資訊，請參閱使用標籤視窗來處理標籤。
注意
當您套用已存在名稱的標籤時，系統會警告您，並詢問您是否要繼續。 如果您選取 [ 確定 ] 繼續，TFVC 會將該標籤從您套用標籤的路徑中的任何項目中移除。
重新命名標籤
您無法修改現有標籤的名稱。 但是，您可以輕鬆地將新標籤套用至完全相同的檔案，以及另一個標籤所套用的相同版本。
在 [原始檔控制總管] 中，以滑鼠右鍵按兩下專案集合節點（根節點），然後選取 [進階>套用標籤]。 [ 新增標籤 ] 對話框隨即出現。
在 [ 名稱] 方塊中，輸入標籤名稱。
（選擇性）在 [ 批注] 方塊 中，輸入批注。
在 [ 版本] 清單中，選取 [ 卷標]。 [ 卷標] 方塊隨即出現。
採取下列其中一個步驟：
輸入現有標籤的名稱。
如果您不確定現有標籤的名稱，請選取 [捲標] 方塊旁邊的省略號 （...） 瀏覽按鈕。 [ 尋找卷標 ] 對話框隨即出現。 使用 [ 尋找卷標 ] 對話框中的選項來篩選標籤清單，並尋找您要套用新標籤的現有標籤。 如需詳細資訊，請參閱 尋找、編輯和移除標籤。
選取 建立。
（選擇性）建立新標籤之後，您可以移除舊的標籤。 如需詳細資訊，請參閱 尋找、編輯和移除標籤。
列出、尋找、檢視、編輯和移除標籤
有兩種方式可以列出和尋找標籤：[尋找卷標] 對話框和 [記錄] 視窗中的 [捲標] 索引標籤。 找到您感興趣的標籤之後，您可以檢視、編輯或移除標籤。 您也可以使用標籤所套用的檔案。
使用 [尋找標籤] 對話框尋找和使用標籤
在原始檔控制總管的功能表欄上，選取 [檔案>原始檔控制>尋找標籤>]。 [ 尋找卷標 ] 對話框隨即出現。
（選擇性）執行下列一或多個步驟來精簡搜尋：
在 [ 名稱] 文字框中，輸入標籤的名稱。
在 [ 專案 ] 清單中，選取包含您要尋找之標籤的專案。
在 [ 擁有者 ] 文本框中，輸入標籤擁有者的名稱或別名。
選取尋找。 [ 結果] 列表會顯示符合您輸入之搜尋準則的標籤。
（選擇性）採取下列步驟之一：
若要檢視或編輯標籤，請選取標籤，然後選取 [ 編輯]。 [卷 標 ] 視窗隨即出現。 如需詳細資訊，請參閱 使用標籤視窗來處理標籤。
若要刪除標籤，請選取標籤，然後選取 [ 刪除]。
選取關閉。
列出並處理套用至特定項目的標籤
有時候您可能不確定標籤的名稱，但您知道標籤已套用至版本控制下的特定專案。 下列程序說明如何在此情況下尋找和使用標籤。
在 [原始檔控制總管] 中，以滑鼠右鍵按兩下已套用標籤的專案，然後選取 [ 檢視記錄]。 [ 歷程記錄] 視窗隨即出現。
選取 [ 標籤] 索引標籤，以顯示套用至此項目的標籤清單。
（選擇性）採取下列步驟之一：
若要檢視或編輯標籤，請以滑鼠右鍵按鍵，然後選取[ 編輯卷標]。 [卷 標 ] 視窗隨即出現。 如需如何使用這個視窗的資訊，請參閱 使用標籤視窗來處理標籤。
若要刪除標籤，請以滑鼠右鍵按鍵按鍵，然後選取[ 刪除卷標]。
以滑鼠右鍵按兩下卷標，然後選取另一個動作，例如 [取得此版本 ] 或 [比較]。
如需如何在 [歷程記錄] 視窗中使用標籤索引標籤的詳細資訊，請參閱取得專案的歷程記錄。
將已標記的檔案版本下載到您的工作區
標記一組檔案就像擷取它們在特定時間點存在方式的快照集。 建立此快照集後的數周或數月，您可能需要檢視或處理該快照集中存在的檔案。 下列程序說明如何將一組已標記的檔案版本下載到您的工作區。
在 [原始檔控制總管] 中，以滑鼠右鍵按兩下包含您要下載之專案的專案集合、專案、分支或資料夾，然後選取[進階>取得特定版本]。 [ 取得 ] 對話框隨即出現。
從 [類型] 列表中選取 [卷標]，然後在 [卷標] 方塊中輸入標籤名稱，或選取省略號 （...） 以開啟 [尋找卷標] 對話框。 如需如何使用此對話框的詳細資訊，請參閱 尋找、編輯和移除標籤。
在 [ 取得 ] 對話框中選取任何其他適當的選項。
選取 [取得]。
使用 [標籤] 視窗來處理標籤
使用上述其中一個程序開啟 [ 卷標 ] 視窗之後，您就可以開始使用標籤。 在視窗頂端，方塊會顯示您可以編輯的批注。
您可以使用 [ 捲標 ] 視窗來執行下列工作：
- 將專案新增至標籤
- 從標籤移除專案
- 變更檔案的版本
- 對項目執行其他動作
將專案新增至標籤
在 [ 卷標] 視窗中，選取 [ 新增專案]。 [ 選擇專案版本] 對話框隨即出現。
在 [ 選擇專案版本] 對話框中，流覽至您要新增的項目，然後加以選取。
提示
您可以選取並按住 Ctrl 或 Shift 鍵，然後選取多個專案。
（選擇性）如果您需要標籤以特定版本為目標，請從 [ 版本 ] 清單中選取版本：
最新版本：將標籤套用至版本控制中的最新版本。
Changeset：在 [變更集] 方塊中 指定變更集 的數目。 或者，選取省略號 （...） 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊，請參閱 尋找和檢視變更集。
日期：在 [日期] 方塊中指定日期，或從下拉菜單的行事曆中選取日期。
標籤：指定要根據新標籤的現有標籤。 在 [卷標] 方塊中輸入標籤名稱，或選取省略號 （...） 以開啟 [尋找卷標] 對話框。 如需詳細資訊，請參閱 尋找、編輯和移除標籤。
工作區版本：在工作區中建立版本的標籤。
選取 [確定]。
選取檔案>儲存。
從標籤移除專案
在 [卷標] 視窗中，找出您要從此標籤中移除的集合、專案、分支、資料夾或檔案。
以滑鼠右鍵按兩下項目，然後選取 [ 從標籤移除]。 標籤會從專案中移除。 如果專案是專案集合、專案、分支或資料夾，則標籤也會從它所包含的所有專案中移除。
選取檔案>儲存。
變更檔案的版本
在 [卷標] 視窗中，找出您要修改的檔案。
以滑鼠右鍵按下檔案，然後選取 [ 變更標籤的版本]。 [ 變更標籤的版本] 對話框隨即出現。
選取下列其中一個值：
最新版本：將標籤套用至版本控制中的最新版本。
Changeset：在 [變更集] 方塊中 指定變更集 的數目。 或者，選取省略號 （...） 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊，請參閱 尋找和檢視變更集。
日期：在 [日期] 方塊中指定日期，或從下拉菜單的行事曆中選取日期。
標籤：指定要根據新標籤的現有標籤。 在 [卷標] 方塊中選取標籤名稱，或選取省略號 （...） 以開啟 [尋找卷標] 對話框。 如需詳細資訊，請參閱 尋找、編輯和移除標籤。
工作區版本：在工作區中建立版本的標籤。
選取檔案>儲存。
對已標記的專案執行其他動作
當您以滑鼠右鍵按下 [標籤] 視窗中的專案時，您也可以選取下列其中一個命令：
從命令提示字元工作
labels使用 命令來列出標籤。 如需詳細資訊，請參閱 Labels 命令。label使用 命令來套用或移除標籤。 如需詳細資訊，請參閱 Label 命令 （Team Foundation 版本控制）。提示
當您使用
label命令來套用標籤時，可以指定專案以外的範圍。