• 标签的类型
• 分配和取消分配标签
• 查看可用标签
  • 查看项目标签
  • 查看群组标签
• 创建标签
  • 创建项目标签
  • 从议题或合并请求创建项目标签
  • 创建群组标签
  • 从史诗创建群组标签
• 编辑标签
  • 编辑项目标签
  • 编辑群组标签
• 删除标签
  • 删除项目标签
  • 删除群组标签
• 将项目标签提升为群组标签
• 将子群组标签提升到父群组
• 生成默认项目标签
• 范围标签
  • 根据范围标签筛选
  • 范围标签示例
  • 嵌套范围
• 在使用标签时接收通知
• 设置标签优先级
• 当合并请求被合并时锁定标签
• 相关主题

{{< details >}}

• Tier: 基础版，专业版，旗舰版
• Offering: JihuLab.com，私有化部署

{{< /details >}}

标签在极狐GitLab 功能中组织和跟踪工作。随着项目从小团队发展到大型组织，标签可以帮助你跟踪和管理越来越多的工作量。标签：

1. 使用自定义属性对议题、合并请求和史诗进行分类。
2. 在列表和看板中筛选内容。
3. 用颜色和描述性标题来优先安排工作项目。
4. 使用范围标签跟踪优先级和严重性。
5. 通过有组织的分组结构化工作流。

标签的类型

你可以在极狐GitLab 中使用两种类型的标签：

1. 项目标签 只能分配给该项目中的议题和合并请求。
2. 群组标签 可以分配给选定群组或其子群组中的任何项目中的议题、合并请求和 史诗。

分配和取消分配标签

{{< history >}}

• 在极狐GitLab 14.10 中以名为 realtime_labels 的 功能标志 引入了侧边栏的实时更新，默认情况下禁用。
• 在极狐GitLab 15.1 中在 JihuLab.com 上启用了侧边栏的实时更新。
• 在极狐GitLab 15.5 中默认启用了侧边栏的实时更新。
• 在极狐GitLab 15.6 中侧边栏的实时更新已普遍可用。功能标志 realtime_labels 被移除。

{{< /history >}}

你可以将标签分配给任何议题、合并请求或史诗。

更改的标签立即对其他用户可见，无需刷新页面，以下内容适用：

1. 史诗
2. 事件
3. 议题
4. 合并请求

要分配或取消分配标签：

1. 在侧边栏的 标签 部分中，选择 编辑。
2. 在 分配标签 列表中，通过输入标签名称来搜索标签。你可以反复搜索以添加更多标签。选定的标签会用勾号标记。
3. 选择要分配或取消分配的标签。
4. 要应用对标签的更改，请选择 分配标签 旁边的 X 或选择标签部分外的任何区域。

或者，要取消分配标签，请选择要取消分配的标签上的 X。

你还可以使用 快捷动作 分配和取消分配标签：

1. 使用 /label 分配标签。
2. 使用 /unlabel 移除标签。
3. 使用 /relabel 移除所有标签并分配新的标签。

查看可用标签

查看项目标签

要查看 项目的标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。

或者：

1. 查看议题或合并请求。
2. 在右侧边栏的 标签 部分中，选择 编辑。
3. 选择 管理项目标签。

标签列表包括项目中创建的标签和项目祖先群组中创建的所有标签。对于每个标签，你可以看到它创建时的项目或群组路径。

查看群组标签

要查看 群组的标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的群组。
2. 选择 管理 > 标签。

或者：

1. 查看史诗。
2. 在右侧边栏的 标签 部分中，选择 编辑。
3. 选择 管理群组标签。

列表仅包括群组中创建的所有标签。它不列出群组项目中创建的任何标签。

创建标签

{{< history >}}

• 在极狐GitLab 17.7 中创建标签的最低角色从报告者改为计划者。

{{< /history >}}

先决条件：

• 你必须至少拥有项目或群组的计划者角色。

创建项目标签

要创建项目标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 选择 新标签。
4. 在 标题 字段中，为标签输入简短且描述性名称。你还可以使用此字段创建 范围标签，互斥标签。
5. 可选。在 描述 字段中，输入有关如何以及何时使用此标签的其他信息。
6. 可选。通过从可用颜色中选择或在 背景颜色 字段中输入特定颜色的十六进制颜色值来选择颜色。
7. 选择 创建标签。

从议题或合并请求创建项目标签

{{< history >}}

• 在极狐GitLab 17.7 中创建标签的最低角色从报告者改为计划者。

{{< /history >}}

你还可以从议题或合并请求创建新的项目标签。以这种方式创建的标签属于与议题或合并请求相同的项目。

先决条件：

• 你必须至少拥有项目的计划者角色。

这样做：

1. 查看议题或合并请求。
2. 在右侧边栏的 标签 部分中，选择 编辑。
3. 选择 创建项目标签。
4. 填写名称字段。如果以这种方式创建标签，则无法指定描述。你可以稍后通过 编辑标签 添加描述。
5. 通过从可用颜色中选择或输入特定颜色的十六进制颜色值来选择颜色。
6. 选择 创建。你的标签已创建并已选择。

创建群组标签

要创建群组标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的群组。
2. 选择 管理 > 标签。
3. 选择 新标签。
4. 在 标题 字段中，为标签输入简短且描述性名称。你还可以使用此字段创建 范围标签，互斥标签。
5. 可选。在 描述 字段中，输入有关如何以及何时使用此标签的其他信息。
6. 可选。通过从可用颜色中选择或在 背景颜色 字段中输入特定颜色的十六进制颜色值来选择颜色。
7. 选择 创建标签。

从史诗创建群组标签

{{< details >}}

• Tier: 专业版，旗舰版
• Offering: JihuLab.com，私有化部署

{{< /details >}}

{{< history >}}

• 在极狐GitLab 17.7 中创建群组标签的最低角色从报告者改为计划者。

{{< /history >}}

你还可以从史诗创建新的群组标签。以这种方式创建的标签属于与史诗相同的群组。

先决条件：

• 你必须至少拥有群组的计划者角色。

这样做：

1. 查看史诗。
2. 在右侧边栏的 标签 部分中，选择 编辑。
3. 选择 创建群组标签。
4. 填写名称字段。如果以这种方式创建标签，则无法指定描述。你可以稍后通过 编辑标签 添加描述。
5. 通过从可用颜色中选择，输入特定颜色的十六进制颜色值来选择颜色。
6. 选择 创建。

编辑标签

{{< history >}}

• 在极狐GitLab 17.7 中编辑标签的最低角色从报告者改为计划者。

{{< /history >}}

先决条件：

• 你必须至少拥有项目或群组的计划者角色。

编辑项目标签

要编辑 项目 标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 在要编辑的标签旁边，选择垂直省略号 ({{< icon name=”ellipsis_v” >}})，然后选择 编辑。
4. 选择 保存更改。

编辑群组标签

要编辑 群组 标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的群组。
2. 选择 管理 > 标签。
3. 在要编辑的标签旁边，选择垂直省略号 ({{< icon name=”ellipsis_v” >}})，然后选择 编辑。
4. 选择 保存更改。

删除标签

{{< history >}}

• 在极狐GitLab 17.7 中删除标签的最低角色从报告者改为计划者。

{{< /history >}}

{{< alert type=”warning” >}}

如果你删除标签，它将被永久删除。系统中所有对该标签的引用都将被删除，无法撤销删除。

{{< /alert >}}

先决条件：

• 你必须至少拥有项目的计划者角色。

删除项目标签

要删除 项目 标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 在 订阅 按钮旁边，选择 ({{< icon name=”ellipsis_v” >}})，然后选择 删除。

删除群组标签

要删除 群组 标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的群组。
2. 选择 管理 > 标签。

3. 选择：

   • 在 订阅 按钮旁边，选择 ({{< icon name=”ellipsis_v” >}})。
   • 在要编辑的标签旁边，选择 编辑 ({{< icon name=”pencil” >}})。
4. 选择 删除。

将项目标签提升为群组标签

{{< history >}}

• 在极狐GitLab 17.7 中提升标签的最低角色从报告者改为计划者。

{{< /history >}}

你可能希望使项目标签可用于同一群组中的其他项目。然后，你可以将标签提升为群组标签。

如果同一群组中的其他项目具有相同标题的标签，则它们都会与新的群组标签合并。如果存在具有相同标题的群组标签，它也会合并。

{{< alert type=”warning” >}}

提升标签是永久性操作，无法撤销。

{{< /alert >}}

先决条件：

• 你必须至少拥有项目的计划者角色。
• 你必须至少拥有项目父群组的计划者角色。

要将项目标签提升为群组标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 在 订阅 按钮旁边，选择三个点 ({{< icon name=”ellipsis_v” >}}) 并选择 提升为群组标签。

所有具有旧标签的议题、合并请求、议题板列表、议题板筛选器和标签订阅都分配给新的群组标签。

新群组标签具有与之前项目标签相同的 ID。

将子群组标签提升到父群组

{{< history >}}

• 在极狐GitLab 17.7 中提升标签的最低角色从报告者改为计划者。

{{< /history >}}

不能直接将群组标签提升到父群组。要实现这一点，请使用以下解决方法。

先决条件：

• 必须有一个包含子群组的群组（“父群组”）。
• 父群组中必须有一个子群组，具有你想要提升的标签。
• 你必须至少拥有两个群组的计划者角色。

要“提升”标签到父群组：

1. 在父群组中，使用与原始标签名称相同的名称 创建标签。我们建议使用不同的颜色，以免在执行此操作时混淆两者。

2. 在子群组中，查看 其标签。你应该看到两个标签及其来源：

   

3. 在子群组标签（旧标签）旁边，选择 议题、合并请求 或 史诗。
4. 将新标签添加到具有旧标签的议题、合并请求和史诗中。为了更快地完成此操作，请使用 批量编辑。
5. 在子群组或父群组中，删除属于低级群组的标签 删除标签。

现在你应该在父群组中有一个与旧标签同名的标签，并且已添加到相同的议题、合并请求和史诗中。

生成默认项目标签

{{< history >}}

• 在极狐GitLab 17.7 中生成默认标签的最低角色从报告者改为计划者。

{{< /history >}}

如果项目或其父群组没有标签，你可以从标签列表页面生成一组默认的项目标签。

先决条件：

• 你必须至少拥有项目的计划者角色。
• 项目中没有标签。

要将默认标签添加到项目：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 选择 生成一组默认标签。

创建以下标签：

• bug
• confirmed
• critical
• discussion
• documentation
• enhancement
• suggestion
• support

范围标签

{{< details >}}

• Tier: 专业版，旗舰版
• Offering: JihuLab.com，私有化部署

{{< /details >}}

团队可以使用范围标签为议题、合并请求和史诗添加互斥标签。通过防止某些标签一起使用，你可以创建更复杂的工作流程。

范围标签在其标题中使用双冒号 (::) 语法，例如：workflow::in-review。

议题、合并请求或史诗不能同时具有两个形式为 key::value 的范围标签，具有相同的 key。如果你添加具有相同 key 但不同 value 的新标签，则上一个 key 标签会被新标签替换。

根据范围标签筛选

要根据给定范围筛选议题、合并请求或史诗列表，请在搜索标签名称中输入 <scope>::*。

例如，筛选 platform::* 标签将返回具有 platform::iOS、platform::Android 或 platform::Linux 标签的议题。

{{< alert type=”note” >}}

在议题或合并请求仪表板页面上无法通过范围标签进行筛选。

{{< /alert >}}

范围标签示例

示例 1. 更新议题优先级：

1. 你决定某个议题优先级较低，并分配 priority::low 标签。
2. 经过更多审查后，你意识到议题的优先级更高，并分配 priority::high 标签。
3. 因为议题不应同时具有两个优先级标签，所以极狐GitLab 移除 priority::low 标签。

示例 2. 你希望议题中的自定义字段能跟踪你的功能目标的操作系统平台，其中每个议题只能针对一个平台。

你创建三个标签：

• platform::iOS
• platform::Android
• platform::Linux

如果你分配这些标签中的任何一个给议题，会自动移除其他任何以 platform:: 开头的现有标签。

示例 3. 你可以使用范围标签表示团队的工作流状态。

假设你有以下标签：

• workflow::development
• workflow::review
• workflow::deployed

如果议题已经具有标签 workflow::development，开发人员希望表明议题现在正在审查中，他们分配 workflow::review，然后移除 workflow::development 标签。

在 议题板 中，将议题移动到标签列表中时也是这样。通过范围标签，不在议题板中工作的团队成员也可以在议题中一致地推进工作流状态。

有关视频说明，请参阅：

嵌套范围

你可以通过在创建标签时使用多个双冒号 :: 来创建具有嵌套范围的标签。在这种情况下，最后一个 :: 之前的所有内容都是范围。

例如，如果你的项目有这些标签：

• workflow::backend::review
• workflow::backend::development
• workflow::frontend::review

议题 不能 同时具有 workflow::backend::review 和 workflow::backend::development 标签，因为它们共享相同的范围：workflow::backend。

另一方面，议题 可以 同时具有 workflow::backend::review 和 workflow::frontend::review 标签，因为它们具有不同的范围：workflow::frontend 和 workflow::backend。

在使用标签时接收通知

你可以订阅标签，以便在标签被分配给议题、合并请求或史诗时 接收通知。

要订阅标签：

1. 查看标签列表页面。
2. 在任何标签的右侧，选择 订阅。

3. 可选。如果你从项目订阅群组标签，请选择：

   • 在项目级别订阅 以接收有关此项目中事件的通知。
   • 在群组级别订阅 以接收有关整个群组中事件的通知。

设置标签优先级

{{< history >}}

• 在极狐GitLab 17.7 中设置标签优先级的最低角色从报告者改为计划者。

{{< /history >}}

标签可以具有相对优先级，当你按 标签优先级 和 优先级 对议题和合并请求列表进行排序时使用。

在优先排序标签时，你必须在项目中执行此操作。无法从群组标签列表中进行此操作。

{{< alert type=”note” >}}

优先排序仅基于最高优先级标签。

{{< /alert >}}

先决条件：

• 你必须至少拥有项目的计划者角色。

要优先排序标签：

1. 在左侧边栏，选择 搜索或转到 并找到你的项目。
2. 选择 管理 > 标签。
3. 在要优先排序的标签旁边，选择星星 ({{< icon name=”star-o” >}})。

此标签现在在标签列表顶部显示在 优先排序标签 下。

要更改这些标签的相对优先级，请在列表中上下拖动它们。列表中较高的标签获得较高的优先级。

要了解按优先级或标签优先级排序时会发生什么，请参阅 排序和排列议题列表。

当合并请求被合并时锁定标签

{{< details >}}

• Tier: 基础版，专业版，旗舰版
• Offering: 极狐GitLab 私有化部署
• Status: Beta

{{< /details >}}

{{< history >}}

• 在极狐GitLab 16.3 中以名为 enforce_locked_labels_on_merge 的标志引入了 合并时锁定标签。该功能为 Beta。默认禁用。
• 在极狐GitLab 17.7 中锁定标签的最低角色从报告者改为计划者。

{{< /history >}}

{{< alert type=”flag” >}}

此功能的可用性由功能标志控制。有关更多信息，请参阅历史记录。此功能可用于测试，但尚未准备好用于生产环境。

{{< /alert >}}

为了符合某些审计要求，你可以设置标签为锁定。当合并请求的锁定标签被合并时，任何人都无法从合并请求中移除它们。

当你将锁定标签添加到议题或史诗时，它们的行为与常规标签相同。

先决条件：

• 你必须至少拥有项目或群组的计划者角色。

{{< alert type=”warning” >}}

在你设置标签为锁定后，任何人都无法撤销或删除该标签。

{{< /alert >}}

要设置标签在合并时锁定：

1. 在左侧边栏，选择 搜索或转到 并找到你的群组或项目。
2. 选择 管理 > 标签。
3. 在要编辑的标签旁边，选择垂直省略号 ({{< icon name=”ellipsis_v” >}})，然后选择 编辑。
4. 选择 合并请求合并后锁定标签 复选框。
5. 选择 保存更改。

相关主题

在以下教程中练习使用标签：

1. 设置单个项目以进行议题分类
2. 设置议题板以进行团队交接