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