使用標籤在 Azure Repos 中擷取檔案的快照集

發行項
04/04/2024

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 命令來套用標籤時，可以指定專案以外的範圍。