共用方式為


使用標籤在 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 版本控制)。

  1. 在 Visual Studio 的 [檢視] 功能表上,選取 [其他 Windows>原始檔控制總管]。

  2. 在 [原始檔控制總管] 中,以滑鼠右鍵按下您要套用標籤的集合、專案、分支、資料夾或檔案,然後選取 [進階>套用卷標]。 [ 新增標籤 ] 對話框隨即出現。

  3. 在 [ 名稱] 方塊中,輸入標籤名稱。

  4. (選擇性)在 [ 批注] 方塊 中,輸入批注。

  5. 在 [ 版本] 清單中, 預設會選取 [最新版本 ]。 此選項是最常使用的選項。 如果您需要標籤以特定版本為目標,請選取下列其中一個選項:

    • Changeset:在 [變更集] 方塊中 指定變更集 的數目。 或者,選取省略號 (...) 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊,請參閱 尋找和檢視變更集

    • 日期:在 [日期] 方塊中指定日期,或從下拉菜單的行事曆中選取日期。

    • 標籤:指定要根據新標籤的現有標籤。 在 [卷標] 方塊中輸入標籤名稱,或選取省略號 (...) 以開啟 [尋找卷標] 對話框。 如需詳細資訊,請參閱 尋找、編輯和移除標籤

    • 工作區版本:在工作區中建立版本的標籤。

  6. 當您滿意您的設定時,請採取下列步驟之一:

    • 若要套用標籤,請選取 [ 建立]。

    • 若要套用標籤,然後在套用標籤之後加以修改,請選取 [建立] 和 [ 編輯]。 此動作會套用標籤,然後顯示 [ 卷標 ] 視窗。 如需使用標籤視窗編輯標籤的詳細資訊,請參閱使用標籤視窗來處理標籤

注意

當您套用已存在名稱的標籤時,系統會警告您,並詢問您是否要繼續。 如果您選取 [ 確定 ] 繼續,TFVC 會將該標籤從您套用標籤的路徑中的任何項目中移除。

重新命名標籤

您無法修改現有標籤的名稱。 但是,您可以輕鬆地將新標籤套用至完全相同的檔案,以及另一個標籤所套用的相同版本。

  1. 在 [原始檔控制總管] 中,以滑鼠右鍵按兩下專案集合節點(根節點),然後選取 [進階>套用標籤]。 [ 新增標籤 ] 對話框隨即出現。

  2. 在 [ 名稱] 方塊中,輸入標籤名稱。

  3. (選擇性)在 [ 批注] 方塊 中,輸入批注。

  4. 在 [ 版本] 清單中,選取 [ 卷標]。 [ 卷標] 方塊隨即出現。

  5. 採取下列其中一個步驟:

    • 輸入現有標籤的名稱。

    • 如果您不確定現有標籤的名稱,請選取 [捲標] 方塊旁邊的省略號 (...) 瀏覽按鈕。 [ 尋找卷標 ] 對話框隨即出現。 使用 [ 尋找卷標 ] 對話框中的選項來篩選標籤清單,並尋找您要套用新標籤的現有標籤。 如需詳細資訊,請參閱 尋找、編輯和移除標籤

  6. 選取 建立

  7. (選擇性)建立新標籤之後,您可以移除舊的標籤。 如需詳細資訊,請參閱 尋找、編輯和移除標籤

列出、尋找、檢視、編輯和移除標籤

有兩種方式可以列出和尋找標籤:[尋找卷標] 對話框和 [記錄] 視窗中的 [捲標] 索引標籤。 找到您感興趣的標籤之後,您可以檢視、編輯或移除標籤。 您也可以使用標籤所套用的檔案。

使用 [尋找標籤] 對話框尋找和使用標籤

  1. 在原始檔控制總管的功能表欄上,選取 [檔案>原始檔控制>尋找標籤>]。 [ 尋找卷標 ] 對話框隨即出現。

  2. (選擇性)執行下列一或多個步驟來精簡搜尋:

    • 在 [ 名稱] 文字框中,輸入標籤的名稱。

    • 在 [ 專案 ] 清單中,選取包含您要尋找之標籤的專案。

    • 在 [ 擁有者 ] 文本框中,輸入標籤擁有者的名稱或別名。

  3. 選取尋找。 [ 結果] 列表會顯示符合您輸入之搜尋準則的標籤。

  4. (選擇性)採取下列步驟之一:

    • 若要檢視或編輯標籤,請選取標籤,然後選取 [ 編輯]。 [卷 ] 視窗隨即出現。 如需詳細資訊,請參閱 使用標籤視窗來處理標籤

    • 若要刪除標籤,請選取標籤,然後選取 [ 刪除]。

    • 選取關閉

列出並處理套用至特定項目的標籤

有時候您可能不確定標籤的名稱,但您知道標籤已套用至版本控制下的特定專案。 下列程序說明如何在此情況下尋找和使用標籤。

  1. 在 [原始檔控制總管] 中,以滑鼠右鍵按兩下已套用標籤的專案,然後選取 [ 檢視記錄]。 [ 歷程記錄] 視窗隨即出現。

  2. 選取 [ 標籤] 索引標籤,以顯示套用至此項目的標籤清單。

  3. (選擇性)採取下列步驟之一:

    • 若要檢視或編輯標籤,請以滑鼠右鍵按鍵,然後選取[ 編輯卷標]。 [卷 ] 視窗隨即出現。 如需如何使用這個視窗的資訊,請參閱 使用標籤視窗來處理標籤

    • 若要刪除標籤,請以滑鼠右鍵按鍵按鍵,然後選取[ 刪除卷標]。

    • 以滑鼠右鍵按兩下卷標,然後選取另一個動作,例如 [取得此版本 ] 或 [比較]。

如需如何在 [歷程記錄] 視窗中使用標籤索引標籤的詳細資訊,請參閱取得專案的歷程記錄。

將已標記的檔案版本下載到您的工作區

標記一組檔案就像擷取它們在特定時間點存在方式的快照集。 建立此快照集後的數周或數月,您可能需要檢視或處理該快照集中存在的檔案。 下列程序說明如何將一組已標記的檔案版本下載到您的工作區。

  1. 在 [原始檔控制總管] 中,以滑鼠右鍵按兩下包含您要下載之專案的專案集合、專案、分支或資料夾,然後選取[進階>取得特定版本]。 [ 取得 ] 對話框隨即出現。

  2. 從 [類型] 列表中選取 [卷標],然後在 [卷標] 方塊中輸入標籤名稱,或選取省略號 (...) 以開啟 [尋找卷標] 對話框。 如需如何使用此對話框的詳細資訊,請參閱 尋找、編輯和移除標籤

  3. 在 [ 取得 ] 對話框中選取任何其他適當的選項。

  4. 選取 [取得]

使用 [標籤] 視窗來處理標籤

使用上述其中一個程序開啟 [ 卷標 ] 視窗之後,您就可以開始使用標籤。 在視窗頂端,方塊會顯示您可以編輯的批注。

您可以使用 [ 捲標 ] 視窗來執行下列工作:

  • 將專案新增至標籤
  • 從標籤移除專案
  • 變更檔案的版本
  • 對項目執行其他動作

將專案新增至標籤

  1. 在 [ 卷標] 視窗中,選取 [ 新增專案]。 [ 選擇專案版本] 對話框隨即出現。

  2. 在 [ 選擇專案版本] 對話框中,流覽至您要新增的項目,然後加以選取。

    提示

    您可以選取並按住 CtrlShift 鍵,然後選取多個專案。

  3. (選擇性)如果您需要標籤以特定版本為目標,請從 [ 版本 ] 清單中選取版本:

    • 最新版本:將標籤套用至版本控制中的最新版本。

    • Changeset:在 [變更集] 方塊中 指定變更集 的數目。 或者,選取省略號 (...) 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊,請參閱 尋找和檢視變更集

    • 日期:在 [日期] 方塊中指定日期,或從下拉菜單的行事曆中選取日期。

    • 標籤:指定要根據新標籤的現有標籤。 在 [卷標] 方塊中輸入標籤名稱,或選取省略號 (...) 以開啟 [尋找卷標] 對話框。 如需詳細資訊,請參閱 尋找、編輯和移除標籤

    • 工作區版本:在工作區中建立版本的標籤。

  4. 選取 [確定]。

  5. 選取檔案>儲存

從標籤移除專案

  1. 在 [卷標] 視窗中,找出您要從此標籤中移除的集合、專案、分支、資料夾或檔案。

  2. 以滑鼠右鍵按兩下項目,然後選取 [ 從標籤移除]。 標籤會從專案中移除。 如果專案是專案集合、專案、分支或資料夾,則標籤也會從它所包含的所有專案中移除。

  3. 選取檔案>儲存

變更檔案的版本

  1. 在 [卷標] 視窗中,找出您要修改的檔案。

  2. 以滑鼠右鍵按下檔案,然後選取 [ 變更標籤的版本]。 [ 變更標籤的版本] 對話框隨即出現。

  3. 選取下列其中一個值:

    • 最新版本:將標籤套用至版本控制中的最新版本。

    • Changeset:在 [變更集] 方塊中 指定變更集 的數目。 或者,選取省略號 (...) 以開啟 [ 尋找變更集 ] 對話框。 如需詳細資訊,請參閱 尋找和檢視變更集

    • 日期:在 [日期] 方塊中指定日期,或從下拉菜單的行事曆中選取日期。

    • 標籤:指定要根據新標籤的現有標籤。 在 [卷標] 方塊中選取標籤名稱,或選取省略號 (...) 以開啟 [尋找卷標] 對話框。 如需詳細資訊,請參閱 尋找、編輯和移除標籤

    • 工作區版本:在工作區中建立版本的標籤。

  4. 選取檔案>儲存

對已標記的專案執行其他動作

當您以滑鼠右鍵按下 [標籤] 視窗中的專案時,您也可以選取下列其中一個命令:

從命令提示字元工作

下一步