数据重用.问题.问题字段公共预览说明 %}
问题字段允许向整个组织内的问题添加结构化元数据。 为了避免依赖标签或自由文本这种临时解决方法,可以创建诸如优先级、工作量、影响或满足团队具体需求的任何自定义类别等字段。 字段在组织级别定义,并应用于组织中的所有存储库。
关于问题字段类型
每个组织最多可以创建 25 个问题字段。 以下字段类型可用:
- 单选:从预定义列表中选择一个选项。 选项可以具有名称、说明和颜色。
- 文本:捕获自由格式的文本。 URL 会自动检测并显示为可单击的链接。
- 数字:接受数字输入,包括小数。
- 日期:提供用于选择日期的日期选取器。
默认字段
为组织启用问题字段时,会自动创建四个默认字段:
- 优先级 (单选):紧急、高、中、低
- 工作量 (单选):高、中、低
- 开始日期 (日期)
- 目标日期 (日期)
这些默认字段是完全可自定义的。 可以编辑其名称、说明和选项,或者如果它们不适合工作流,请将其删除。
创建问题字段
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击问题字段。
-
单击“新建字段”。
-
在“字段名称”下,键入新字段的名称。
-
(可选)在“说明”下,键入说明以帮助其他人了解字段的目的。
-
在“字段类型”下,选择要创建的字段的类型。
-
如果选择 了“单选”,请为字段添加选项:
- 单击“ 添加”选项 并键入选项名称。
- (可选)若要设置选项的颜色,请单击 旁边的选项,单击 “编辑”选项,选择颜色,然后单击“ 保存”。
- 重复添加更多选项。
-
在“字段可见性”下,选择以下选项之一:
- 权限:选择谁可以查看字段及其值。 选项 仅限组织 (默认)或 公共。 此设置仅适用于公共存储库中的问题。
- 固定到类型:单击 ,以选择在问题查看器和创建器中哪些问题类型显示此字段。 选择一个或多个问题类型,或“没有类型的问题”。 未固定且无值的字段将在问题查看器和创建器中保持隐藏状态。
-
单击 “创建” 。
编辑问题字段
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击问题字段。
-
在要编辑的字段右侧,单击 。
-
单击 “编辑” 并进行更改。
-
单击“ 保存”字段。
删除问题字段
删除问题字段时,将永久删除针对该字段的问题设置的所有值。
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击问题字段。
-
在要删除的字段右侧,单击 。
-
单击“ 删除 ”并确认删除。
重新排序问题字段
固定字段的顺序按问题类型来管理。 字段顺序确定字段在问题边栏和问题创建模式中的显示方式。
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击“ 问题类型”。
-
单击要重新排序字段的问题类型。
-
在“已固定的问题字段”下,拖动字段以对其进行重新排序。
-
单击“ 保存”。
将字段固定到问题类型
可以将问题字段与特定问题类型相关联,以便在创建或查看该类型的问题时仅显示最相关的字段。 例如,可以将“严重性”关联到 bug,将“影响”关联到特性。
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击问题字段。
-
单击要固定的字段。
-
在“固定到类型”下,单击 ,然后选择应显示此字段的问题类型。
-
单击“ 保存”字段。
固定字段自动根据所选问题类型显示在问题边栏中。 若要将字段固定到没有类型的问题,请选择“没有类型的问题”选项。
注意
字段必须被设置为至少一个事项类型,或“无类型事项”,才能显示在事项边栏中。 未固定到任何类型的 字段只能通过“添加字段 ”按钮或在项目中访问。
设置字段可见性
对于具有公共存储库的组织,可以控制每个问题字段对每个人可见,还是仅对组织成员和协作者可见。
-
在 GitHub 的右上角,单击个人资料图片,然后单击“ Your organizations”****。1. 单击以选择一个组织。
-
在组织名称下,单击 “Settings”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

-
在边栏的“规划”部分中,单击问题字段。
-
在字段右侧,单击 。
-
单击 “编辑” 。
-
在“字段可见性”下,选择以下选项之一:
- 仅限组织:该字段仅对至少具有读取访问权限的组织成员和存储库协作者可见。
- 公共:此字段对查看此问题的任何人可见。
-
单击“ 保存”。
默认情况下,所有新字段和现有字段都设置为“仅限组织”。 可见性设置在 Web UI、API、问题时间线事件和搜索建议中强制实施。
问题字段和项目
在贵组织中的任何项目内都可以使用问题字段。 有关在项目中添加、删除和编辑问题字段的详细信息,请参阅 添加和管理问题字段。
项目中的字段限制
项目总共支持最多 50 个字段,问题字段和系统字段计入此限制。 如果项目已处于字段限制,则需要在添加问题字段之前删除现有字段。
限制
| 资源 | Limit |
|---|---|
| 每个组织的问题字段数 | 二十五 |
| 每个单选字段的选项 | 50 |
| 每个问题类型的固定字段数 | 10 |
| 项目中的字段总数(包括问题字段和系统字段) | 50 |