使用 Git 標籤

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Azure DevOps 同時支援批註和輕量標記。 輕量標記是特定認可的指標，而批註標記則包含詳細資訊，例如標記器、訊息和日期。 您可以使用入口網站建立批註標記。 您可以從 Visual Studio 中建立輕量型和批註標記。 如需 Git 標籤的詳細資訊，請參閱 2.6 Git 基本概念 - 從 Pro Git 書籍標記 。

本文提供在 Azure DevOps 和 Visual Studio 中使用 Git 卷標的概觀。

重要

Visual Studio 2017 Update 6 中引進了 Visual Studio 中的標籤檢視。 如果您使用的是早於此版本，您可以從歷程記錄檢視和認可詳細數據檢視，從 Visual Studio 2015 開始檢視和認可詳細數據檢視，但無法如本文所述，在 [捲標] 檢視中執行作業。

檢視和篩選標籤

瀏覽器

您可以在 [卷標] 檢視和入口網站中的 [認可] 檢視中檢視卷標。

注意

使用 Azure DevOps Services 時，專案 URL 的格式為 dev.azure.com/{your organization}/{your project}。 不過，仍支持參考格式的 visualstudio.com 先前格式。 如需詳細資訊，請參閱 Azure DevOps 簡介，將現有組織切換為使用新的功能變數名稱 URL。

在卷標檢視中檢視卷標

1. 若要檢視存放庫中的標籤，請在入口網站中流覽至您的項目，選擇 [存放庫]、[卷標]，然後選取所需的存放庫。

   

   批註標記會以標記名稱、訊息、認可、標記器和建立日期顯示。 輕量型標籤會以標籤名稱和認可顯示。

2. 若要篩選標籤清單，請在 [搜尋卷標名稱] 方塊中輸入搜尋字詞，然後按 Enter 鍵。

   

檢視認可檢視中的標籤

若要在 [認可] 檢視中檢視特定分支的標籤，請在入口網站中瀏覽至您的存放庫，選擇 [存放庫]、[認可]，然後選取您的分支。

Visual Studio

在 [歷程記錄] 檢視中檢視卷標

您可以在 [歷程記錄] 檢視中檢視標籤。

1. 從功能表欄中的 [Git] 選單中，選取 [管理分支]。

2. 若要檢視歷程記錄，請選取分支。

   

   紅色圖形是分支，而綠色圖形則為標記。

在卷標檢視中檢視卷標

注意

Visual Studio 2019 16.8 版和更新版本提供新的 Git 功能表，用於管理 Git 工作流程，其內容切換比 Team Explorer 少。 本文中提供的程式位於 Visual Studio 索引標籤底下，提供使用 Git 體驗以及 Team Explorer 的資訊。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

1. 若要檢視存放庫中的所有標籤，請從 [首頁] 檢視中選取 [卷標]。

   

2. 標籤會顯示在目前連接的存放庫名稱底下。

   

   批註標記會顯示包含標籤名稱、標記器、標記日期和訊息的工具提示。 輕量型標籤在工具提示中只有標籤名稱。

   

   如需標記認可的詳細資訊，請以滑鼠右鍵按兩下卷標，然後選取 [ 檢視認可詳細數據]。

   

3. 若要篩選標籤清單，請在 [在此輸入] 中輸入搜尋字詞 以篩選清單 框。

   

若要從來源存放庫擷取目前的標籤清單，請執行擷 取 作業。

建立標籤

若要建立標籤，您必須具有 [建立卷標] 權限，預設包含在參與者群組和更高層級。

注意

卷標名稱不能包含 ASCII 控制字元，例如空格、Tildes 和冒號。 使用小寫字元和以連字元分隔單字是常見的作法。 標記名稱長度不應超過 250 個 ASCII 字元。 若要避免標記名稱和認可哈希之間的模棱兩可，請勿使用包含 40 個十六進位字元的標籤名稱。 如需標記命名的詳細資訊，請參閱 git-check-ref-format。

瀏覽器

您可以從 [卷標] 檢視和 [認可] 檢視，使用入口網站建立批註標記。

重要

您只能在入口網站或 Visual Studio 中建立批註標記。 若要建立輕量型標籤，您可以使用 Git 命令行。

從卷標檢視建立標籤

1. 從入口網站中的 [卷標] 檢視選取 [建立卷標]，以建立新的批註標記。

   

2. 指定 [名稱]，從中選取 [卷標] 的分支、輸入 [描述] （自您建立批註標記后需要），然後選取 [建立]。

   

3. 新的標籤會顯示在標籤清單中。

   

從認可檢視建立標籤

若要直接從認可檢視建立標記，請以滑鼠右鍵按兩下所需的標籤，然後選擇 [ 建立標籤]。

Visual Studio

您可以從 [歷程記錄] 檢視和 [卷標] 檢視，在 Visual Studio 中同時建立批註和羽量標記。 若要建立批註標記，請在建立標記時提供名稱和訊息。 若要建立輕量型標記，請省略訊息，並只提供名稱。

從 [歷程記錄] 檢視建立標籤

您可以在 [歷程記錄] 檢視中檢視標籤。

1. 從功能表欄中的 [Git] 選單中，選取 [管理分支]。

2. 選取分支以檢視歷程記錄、以滑鼠右鍵按下認可，然後選取 [ 新增卷標]。

   

3. 在 [建立新標籤] 對話框中，僅針對輕量標記輸入標籤名稱或標記名稱和標記訊息的標記名稱。 選取 建立。

從卷標檢視建立標籤

注意

Visual Studio 2019 16.8 版和更新版本提供新的 Git 功能表，用於管理 Git 工作流程，其內容切換比 Team Explorer 少。 本文中提供的程式位於 Visual Studio 索引標籤底下，提供使用 Git 體驗以及 Team Explorer 的資訊。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

1. 在 [卷標] 檢視中選取 [新增卷標]，以建立新的標記。

   

2. 若要根據最新分支的提示建立標籤，請在 [輸入卷標名稱] 方塊中指定名稱、選擇性地提供標記訊息，然後選取 [建立卷標]。

   

   若要選取要建立標記的分支，請清除 [ 針對最新分支 提示建立標籤] 複選框，然後從 [選取分支 ] 下拉式清單中選取分支。

   

3. 新標記會在本機建立。 以滑鼠右鍵按兩下新的標籤，然後選擇 [ 推送 ] 將它推送至遠端存放庫。 選取 [ 全部 推送] 以將所有新的本機標籤推送至遠端存放庫。

   

您可以透過 Azure DevOps REST API 以程式設計方式建立批註標記。 若要使用 git tag 命令透過 Azure 管線建立標籤。 如需詳細資訊，請參閱 git 標籤。

刪除標記

重要

從存放庫刪除標籤時請小心。 如果存放庫已由其他使用者提取、分叉或複製，標籤仍會存在於其存放庫複本中。 您應該只刪除本機標籤，或者如果您確定自建立標記之後，存放庫尚未提取、複製或分岔。

若要刪除標籤，您必須具有存放庫層級的強制推送許可權或 [所有標籤] 層級（如果未明確設定，則會從存放庫層級繼承其許可權）。 建立者也會繼承 標籤的強制推送 許可權。

瀏覽器

刪除遠端存放庫中的標籤

此程式中的步驟會示範如何使用 Azure DevOps Services 入口網站刪除遠端存放庫中的標籤。

1. 若要刪除標籤，請選取標籤名稱右邊的省略號，然後選擇 [ 刪除卷標]。

   

2. 請選取刪除，確認刪除。

   

3. 標記已刪除，下次流覽至 [卷標 ] 檢視時將不會顯示。

   

Visual Studio

注意

Visual Studio 2019 16.8 版和更新版本提供新的 Git 功能表，用於管理 Git 工作流程，其內容切換比 Team Explorer 少。 本文中提供的程式位於 Visual Studio 索引標籤底下，提供使用 Git 體驗以及 Team Explorer 的資訊。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

此程式中的步驟示範如何使用 Visual Studio 2019 Team Explorer 刪除本機存放庫中的標籤。

以滑鼠右鍵按下要刪除的標籤，然後選擇 [ 在本機刪除]

重要

如果您的標籤已推送至遠端存放庫，您就不應該將其刪除。 如果存放庫已由其他使用者提取、分叉或複製，標籤仍會存在於其存放庫複本中。 您應該只刪除本機標籤。

從標記建立分支

瀏覽器

1. 若要從標記建立分支，請選取標籤名稱右邊的省略號，然後選擇 [ 新增分支]。

   

2. 指定 [名稱]，選擇性地選取要連結的任何 [工作] 項目，然後選擇 [建立分支]。

   

3. 分支會建立，而您將會前往入口網站中的新分支。

   

Visual Studio

此程式中的步驟示範如何使用 Visual Studio 2019 Team Explorer 從標記建立分支。 針對使用 Git 功能表或 Visual Studio 2022 的 Visual Studio 2019，請使用瀏覽器。

注意

Visual Studio 2019 16.8 版和更新版本提供新的 Git 功能表，用於管理 Git 工作流程，其內容切換比 Team Explorer 少。 本文中提供的程式位於 Visual Studio 索引標籤底下，提供使用 Git 體驗以及 Team Explorer 的資訊。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

1. 若要從標籤建立分支，請以滑鼠右鍵按鍵，然後選擇 [ 新增本機分支的來源]。 您也可以選擇 [ 從標記建立分支]。

   

2. 指定分支名稱、確認所需的標籤，然後選擇 [ 建立分支]。 若要簽出新的分支，請選擇 [簽出分支]。

   

3. 若要檢視新建立的分支，請從 [首頁] 檢視中選取 [分支]。

   

4. 新的分支會在本機建立。 若要推送分支，請以滑鼠右鍵按兩下它，然後選擇 [ 推送分支]。

   

檢視標籤歷程記錄

瀏覽器

1. 若要檢視卷標的歷程記錄，請選取標籤名稱右邊的省略號，然後選擇 [ 檢視記錄]。

   

2. 系統會帶您前往標記的認可檢視。

   

Visual Studio

此程式中的步驟示範如何使用 Visual Studio 2019 Team Explorer 來檢視卷標歷程記錄。 針對使用 Git 功能表或 Visual Studio 2022 的 Visual Studio 2019，請使用瀏覽器。

注意

Visual Studio 2019 16.8 版和更新版本提供新的 Git 功能表，用於管理 Git 工作流程，其內容切換比 Team Explorer 少。 本文中提供的程式位於 Visual Studio 索引標籤底下，提供使用 Git 體驗以及 Team Explorer 的資訊。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

1. 若要檢視卷標的歷程記錄，請以滑鼠右鍵按鍵，然後選擇 [ 檢視記錄]。

   

2. 記錄會顯示在 [歷程記錄] 檢視中。