Labels · Gitlab 中文文檔

# Labels > 原文：[https://docs.gitlab.com/ee/user/project/labels.html](https://docs.gitlab.com/ee/user/project/labels.html) * [Overview](#overview) * [Project labels and group labels](#project-labels-and-group-labels) * [Assign and unassign labels](#assign-and-unassign-labels) * [Label management](#label-management) * [Project labels](#project-labels) * [Promote a project label to a group label](#promote-a-project-label-to-a-group-label) * [Group labels](#group-labels) * [Create group labels from epics](#create-group-labels-from-epics-ultimate) * [Generate default labels](#generate-default-labels) * [Scoped labels](#scoped-labels-premium) * [Workflows with scoped labels](#workflows-with-scoped-labels) * [Scoped labels with nested scopes](#scoped-labels-with-nested-scopes) * [Subscribing to labels](#subscribing-to-labels) * [Label priority](#label-priority) * [Troubleshooting](#troubleshooting) * [Some label titles end with `_duplicate<number>`](#some-label-titles-end-with-_duplicatenumber) # Labels[](#labels "Permalink") ## Overview[](#overview "Permalink") 隨著您在 GitLab 中問題，合并請求和史詩數量的增長，跟蹤這些項目變得越來越困難. 尤其是隨著您的組織從只有幾個人發展到成百上千. 標簽就是在這里出現的.它們可以幫助您組織和標記工作，以便您可以跟蹤和找到您感興趣的工作項. 標簽是[發行板](issue_board.html)的關鍵部分. 使用標簽，您可以： * 使用顏色和描述性標題（例如`bug` ， `feature request`或`docs`對史詩，問題和合并請求進行分類. * 動態過濾和管理史詩，問題和合并請求. * [搜索問題列表，合并請求和史詩](../search/index.html#issues-and-merge-requests)以及[問題面板](../search/index.html#issue-boards) . ## Project labels and group labels[](#project-labels-and-group-labels "Permalink") GitLab 中有兩種類型的標簽： * **項目標簽**只能分配給該項目，并且只能合并該項目中的請求. * 可以將**組標簽**分配給選定組或其子組中的任何項目中的問題并合并請求. * 也可以將它們分配給所選組或其子組中的史詩. ## Assign and unassign labels[](#assign-and-unassign-labels "Permalink") 每個問題，合并請求和史詩都可以分配任意數量的標簽. 標簽在右側欄中管理，您可以在其中根據需要分配或取消分配標簽. 要將標簽分配給問題，請合并請求或史詩： 1. 在側邊欄的標簽部分，點擊**編輯** ，然后： * 在列表中，單擊所需的標簽. 每個標簽都帶有復選標記. * 通過輸入搜索查詢并單擊搜索來查找標簽（），然后點擊它們. 您可以反復搜索并添加更多標簽. 2. 單擊**X**或標簽部分之外的任何位置，然后將應用標簽. 您也可以使用[`/assign @username`快速操作](quick_actions.html)來分配標簽. ## Label management[](#label-management "Permalink") 具有 Reporter 或更高[權限級別](../permissions.html)的用戶可以創建和編輯標簽. ### Project labels[](#project-labels "Permalink") 通過轉到項目并單擊**問題>標簽**來查看項目標簽列表. 該列表包括在項目級別定義的所有標簽，以及從直接父組繼承的所有標簽. 您可以通過在頂部輸入搜索查詢并點擊搜索（）. 要創建一個新的項目標簽： 1. 導航到項目中的" **問題">"標簽** ". 2. 單擊**新建標簽**按鈕. * 輸入標題. * （可選）輸入描述. * （可選）通過單擊可用顏色來選擇背景顏色，或輸入特定顏色的十六進制顏色值. 3. 單擊**創建標簽**以創建標簽. 您也可以從發布或合并請求中創建新的項目標簽. 在問題或合并請求的右側欄中的標簽部分： 1. Click **Edit**. 2. Click **創建項目標簽**. * 填寫名稱字段. 請注意，如果以此方式創建標簽，則無法指定描述. 您可以稍后通過編輯標簽來添加描述（請參見下文）. * （可選）通過單擊可用顏色來選擇顏色，或輸入特定顏色的十六進制顏色值. 3. Click **Create**. 創建標簽后，您可以通過點擊鉛筆（），或通過單擊三個點（）旁邊的" **訂閱"**按鈕，然后選擇" **刪除"** . #### Promote a project label to a group label[](#promote-a-project-label-to-a-group-label "Permalink") 如果您以前創建了項目標簽，現在想使其可用于同一組中的其他項目，則可以將其升級為組標簽. 如果同一組中的其他項目具有相同標題的標簽，則它們將全部與新的組標簽合并. 如果存在具有相同標題的組標簽，則它也會被合并. 所有發行，合并請求，發行板列表，發行板過濾器以及帶有舊標簽的標簽訂閱都將分配給新的組標簽. 警告： **警告：**提升標簽是永久性的操作，不能撤消. 要將項目標簽提升為組標簽： 1. 導航到項目中的" **問題">"標簽** ". 2. 單擊三個點（）旁邊的**訂閱**按鈕，然后選擇**升級為組標簽** . ### Group labels[](#group-labels "Permalink") 通過轉到組并單擊**問題>標簽**來查看組標簽列表. 該列表包括僅在組級別定義的所有標簽. 它沒有列出項目中定義的任何標簽. 您可以通過在頂部輸入搜索查詢并點擊搜索（）. 要創建**組標簽** ，請導航到**組中的"** **問題">"標簽"** ，并按照與[創建項目標簽](#project-labels)相同的過程進行操作. #### Create group labels from epics[](#create-group-labels-from-epics-ultimate "Permalink") 您可以從 Epic 側邊欄創建組標簽. 您創建的標簽將屬于該史詩所屬的直接組. 該過程與根據[發布或合并請求](#project-labels)創建[項目標簽](#project-labels)的過程相同. ### Generate default labels[](#generate-default-labels "Permalink") 如果項目或組沒有標簽，則可以從標簽列表頁面生成一組默認的項目或組標簽. 如果列表為空，該頁面將顯示一個" **生成默認標簽集"**按鈕，單擊該按鈕會將以下默認標簽添加到項目中： * `bug` * `confirmed` * `critical` * `discussion` * `documentation` * `enhancement` * `suggestion` * `support` ## Scoped labels[](#scoped-labels-premium "Permalink") [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/9175) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10. 范圍標簽允許團隊使用標簽功能來注釋問題，合并請求和具有互斥標簽的史詩. 通過防止某些標簽一起使用，可以啟用更復雜的工作流程. 當標簽標題中使用特殊的雙冒號（ `::` :）語法時，該標簽將成為作用域，例如： [![Sample scoped labels](https://img.kancloud.cn/35/44/354431772cf60458fa71ee600f39c0d6_2428x651.png)](img/labels_key_value_v12_1.png) issue，merge request 或 epic 不能具有形式為`key::value`且具有相同`key`兩個范圍標簽. 使用相同的`key`添加一個新標簽，但是使用不同的`value`將導致以前的`key`標簽被新標簽替換. 用例示例： 1. 一個問題被標識為低優先級，并向其添加了`priority::low`項目標簽. 2. 經過更多審查后，問題優先級增加了，并添加了`priority::high`標簽. 3. manbetx 客戶端打不開會自動刪除`priority::low`標簽，因為一個問題不應同時具有兩個優先級標簽. ### Workflows with scoped labels[](#workflows-with-scoped-labels "Permalink") 假設您要在問題中創建一個自定義字段，以跟蹤功能所針對的操作系統平臺，而每個問題只應針對一個平臺. 然后，您將創建三個標簽`platform::iOS` ， `platform::Android` ， `platform::Linux` . 在給定的問題上應用這些標簽中的任何一個都會自動刪除以`platform::`開頭的任何其他現有標簽. 可以將相同的模式應用于代表團隊的工作流狀態. 假設您具有標簽以下標簽`workflow::development` ， `workflow::review`和`workflow::deployed` . 如果一個問題已經應用了標簽`workflow::development` ，并且開發人員想要將該問題推進到`workflow::review` ，他們將簡單地應用該標簽，然后`workflow::development`標簽將被自動刪除. 當您在整個標簽列表中移動的問題這種行為已經存在[問題板](issue_board.html#create-workflows) ，但現在，誰可能無法在一個問題板上工作的團隊成員直接將仍然能夠推進工作流程中的問題始終國家本身. 在有關[將范圍標簽用于自定義字段和工作流](https://www.youtube.com/watch?v=4BCBby6du3c)的視頻中演示了此功能. ### Scoped labels with nested scopes[](#scoped-labels-with-nested-scopes "Permalink") 創建標簽時，可以使用多個雙冒號`::`來創建具有嵌套作用域的標簽. 在這種情況下，最后一個`::`之前的所有內容都將成為作用域. 例如， `workflow::backend::review`和`workflow::backend::development`是有效的作用域標簽，但是它們**不能同時**存在于同一問題上，因為它們都共享相同的作用域， `workflow::backend` . 此外， `workflow::backend::review`和`workflow::frontend::review`是有效的范圍標簽，并且它們**可以同時**存在于同一問題上，因為它們都具有不同的范圍， `workflow::frontend`和`workflow::backend` . ## Subscribing to labels[](#subscribing-to-labels "Permalink") 在項目標簽列表頁面和組標簽列表頁面中，您可以單擊任何標簽右側的**訂閱**以啟用該標簽的[通知](../profile/notifications.html) . 只要將標簽分配給史詩，發行或合并請求，您就會收到通知. 如果要從項目內訂閱組標簽，則可以選擇僅訂閱項目或整個組的標簽通知. [![Labels subscriptions](https://img.kancloud.cn/cd/6b/cd6ba29cc25887f91c2bf9294d748007_2070x538.png)](img/labels_subscriptions_v12_1.png) ## Label priority[](#label-priority "Permalink") 版本歷史 * 在 GitLab 8.9 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/14189) . * 優先級排序僅基于最高優先級標簽. [討論中](https://gitlab.com/gitlab-org/gitlab/-/issues/14523)考慮改變這一點. 標簽可以具有相對優先級，在史詩，發布和合并請求列表頁面的" **標簽優先級"**和" **優先級"**排序順序中使用. 組標簽和項目標簽的優先級都在項目級別進行，不能從組標簽列表中進行. 在項目標簽列表頁面上，在標簽上加上星號以表明它具有優先級. [![Labels prioritized](https://img.kancloud.cn/81/5f/815f3c8a4a321a5b18b1c92638ca0d5d_1954x1000.png)](img/labels_prioritized_v12_1.png) 在列表中上下拖動已加星標的標簽以更改其優先級，列表中的較高表示優先級較高. [![Drag to change label priority](https://img.kancloud.cn/1f/2e/1f2e4f8f356e0f0fa28f5ce34f9fee67_1896x480.png)](img/labels_drag_priority_v12_1.gif) 在史詩般的，合并請求和問題列表頁面上（針對組和項目），您可以按`Label priority`或`Priority`進行排序. 如果您按`Label priority`排序，則 GitLab 將使用以下排序比較順序： 1. 具有較高優先級標簽的項目. 2. 沒有優先標簽的項目. 領帶被任意打破. 請注意，只會檢查優先級最高的標簽，而忽略優先級較低的標簽. 有關更多信息，請參見此[相關問題](https://gitlab.com/gitlab-org/gitlab/-/issues/14523) . [![Labels sort label priority](https://img.kancloud.cn/bb/03/bb03f4aa754d6c48b34b3938af152604_1200x502.png)](img/labels_sort_label_priority.png) 如果您按`Priority`排序，則 GitLab 將使用以下排序比較順序： 1. 具有里程碑的截止日期的項目，最早分配的[里程碑](milestones/index.html)在此列出. 2. 具有里程碑的項目，沒有截止日期. 3. 具有較高優先級標簽的項目. 4. 沒有優先標簽的項目. 領帶被任意打破. [![Labels sort priority](https://img.kancloud.cn/9b/cd/9bcdd63ac4a451b821e4bdcc42c61e92_1200x506.png)](img/labels_sort_priority.png) ## Troubleshooting[](#troubleshooting "Permalink") ### Some label titles end with `_duplicate<number>`[](#some-label-titles-end-with-_duplicatenumber "Permalink") 在特定情況下，可以在同一名稱空間中創建具有重復標題的標簽. 為了解決重復問題， [在 GitLab 13.2](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/21384)和更高版本中，某些重復標簽的標題后面`_duplicate<number>` . 如果愿意，可以安全地更改這些標簽的標題. 有關原始問題的詳細信息，請參見[問題 30390](https://gitlab.com/gitlab-org/gitlab/issues/30390) .