在您的组织中管理问题字段 - GitHub 文档

注意

问题字段目前处于公开预览阶段，可能会有更改。若要提供反馈，请参阅社区讨论。

问题字段让您可以在组织的所有问题中添加结构化元数据。与其依赖标签或自由文本的变通方法，您可以创建诸如优先级、工作量、影响或团队需要的任何自定义类别的字段。字段在组织层面定义，并适用于组织中的所有代码库。

关于问题字段类型

每个组织最多可创建 25 个问题字段。以下字段类型可用

单选：从预定义列表中选择一个选项。选项可以有名称、描述和颜色。
文本：捕获自由格式文本。URL 会自动检测并显示为可点击的链接。
数字：接受数字输入，包括小数。
日期：提供日期选择器以选择日期。

默认字段

当为组织启用问题字段时，会自动创建四个默认字段

优先级（单选）：紧急、高、中、低
工作量（单选）：高、中、低
开始日期（日期）
目标日期（日期）

这些默认字段可以完全自定义。您可以编辑它们的名称、描述和选项，或在它们不符合您的工作流时将其删除。

创建问题字段

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题字段。
点击 新建字段。
在“字段名称”下，输入新字段的名称。
可选地，在“描述”下，输入描述以帮助其他人理解该字段的用途。
在“字段类型”下，选择您想创建的字段类型。
如果您选择了单选，请为该字段添加选项
- 点击 添加选项 并输入选项名称。
- 可选地，要为选项设置颜色，请点击选项旁边，点击 编辑选项，选择颜色，然后点击保存。
- 重复此操作以添加更多选项。
在“字段可见性”下，选择以下之一
- 权限：选择谁可以看到字段及其值。选项有 仅组织可见（默认）或公开。此设置仅适用于公共仓库中的问题。
- 固定到类型：点击以选择哪些问题类型在问题查看器和创建器中显示此字段。选择一个或多个问题类型，或“没有类型的问题”。未固定且没有值的字段将在问题查看器和创建器中保持隐藏。
点击创建。

编辑问题字段

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题字段。
在要编辑的字段右侧，点击.
点击编辑并进行更改。
点击 保存字段。

删除问题字段

删除问题字段后，该字段在所有问题上设置的值将被永久删除。

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题字段。
在要删除的字段右侧，点击.
点击删除并确认删除。

重新排序问题字段

固定字段的顺序按问题类型管理。字段顺序决定字段在问题侧边栏和问题创建模态框中的显示顺序。

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题类型。
点击您想重新排序字段的问题类型。
在“已固定的问题字段”下，拖动字段以重新排序。
点击保存。

将字段固定到问题类型

您可以将问题字段关联到特定的问题类型，这样在创建或查看该类型的问题时，只会显示最相关的字段。例如，您可以将“严重性”固定到缺陷，将“影响”固定到功能。

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题字段。
点击您想固定的字段。
在“固定到类型”下，点击并选择此字段应出现的问题类型。
点击 保存字段。

已固定的字段会根据所选问题类型自动出现在问题侧边栏中。要将字段固定到没有类型的问题，请选择“没有类型的问题”选项。

注意

字段必须固定到至少一种问题类型，或固定到“没有类型的问题”，才能出现在问题侧边栏中。未固定到任何类型的字段只能通过 添加字段 按钮或在项目中访问。

设置字段可见性

对于拥有公共仓库的组织，您可以控制每个问题字段是对所有人可见，还是仅对组织成员和协作者可见。

在 GitHub 右上角，点击您的个人头像，然后点击组织。
点击即可选择组织。
在您的组织名称下，点击设置。如果看不到“设置”选项卡，请选择下拉菜单，然后点击设置。
在侧边栏的“规划”部分，点击 问题字段。
在字段右侧，点击.
点击编辑。
在“字段可见性”下，选择以下之一
- 仅组织可见：该字段仅对组织成员和具有至少读取权限的仓库协作者可见。
- 公开：该字段对任何查看问题的人可见。
点击保存。

默认情况下，所有新建和现有字段均设置为“仅组织可见”。可见性设置在网页 UI、API、问题时间线事件和搜索建议中均生效。

问题字段与项目

问题字段在组织的任何项目中均可使用。有关在项目中添加、移除和编辑问题字段的详细信息，请参阅添加和管理问题字段。

项目中的字段限制

项目总共支持最多 50 个字段，问题字段和系统字段计入此限制。如果项目已达字段上限，则需要移除现有字段才能添加问题字段。

限制

资源	限制项
每个组织的问题字段	25
每个单选字段的选项数	50
每个问题类型的固定字段数	10
项目中的总字段数（包括问题字段和系统字段）	50

在组织中管理议题字段

谁可以使用此功能？

本文内容