添加和管理议题字段

问题字段显示在问题的右侧边栏中，位于指派人、标签和类型等系统字段旁边。您可以在创建或编辑问题时设置值。当在创建问题时选择问题类型时，任何固定到该类型的字段会自动出现在侧栏中。

设置字段值

1. 转到您想要更新的问题。
2. 在右侧边栏中，如果所需的字段尚未显示，请点击 添加字段。
3. 从下拉列表中选择您想要添加的字段。
4. 设置值
   • 对于 单选 字段，请从下拉列表中选择一个选项。
   • 对于 文本 字段，输入您的值。URL 会被自动识别并显示为链接。
   • 对于 数字 字段，输入数值。
   • 对于 日期 字段，使用日期选择器选择日期，或直接输入日期。
5. 更改会自动保存。

编辑字段值

1. 转到该问题。
2. 在右侧边栏，点击您想要更改的字段值。
3. 选择新值或输入新条目。
4. 更改会自动保存。

清除字段值

1. 转到该问题。
2. 在右侧边栏，点击该字段值。
3. 清除值
   • 对于 单选 字段，点击当前选中的选项以取消选择。
   • 对于 文本 和 数字 字段，删除输入框中的所有文字。
   • 对于 日期 字段，点击日期选择器中的清除按钮。
4. 清除后，该字段会从侧栏中移除。您可以使用 添加字段 按钮重新添加。

已固定字段

如果您所在组织的管理员已将字段固定到特定的问题类型，则在创建或查看该类型的问题时，这些字段会自动出现在侧栏和问题创建模态框中。您无需手动添加已固定的字段。

在时间轴中查看字段更改

当字段值被更改时，更新会记录在问题时间轴中。时间轴条目会显示

• 更改了哪个字段
• 设置的新的值
• 谁进行了更改
• 更改的时间

对可见性设置为“仅组织”的字段的时间轴事件对非组织成员或协作者的用户不可见。

字段可见性

组织管理员可以将每个字段的可见性设置为 “仅组织” 或 “公开”。这会影响您看到的内容

• 如果字段设置为 仅组织，则仅对组织成员和拥有至少只读权限的仓库协作者可见。如果您不是成员或协作者，则该字段不会出现在问题侧栏、时间轴或搜索建议中。
• 如果字段设置为 公开，则对所有查看该问题的人可见。

欲了解有关配置可见性的更多信息，请参阅 在组织中管理问题字段。

在项目中使用问题字段

问题字段可以作为列添加到项目视图中，您可以在其中编辑值、分组、筛选、排序以及构建图表。更多信息，请参阅 项目中问题字段概述。

通过字段值搜索

您可以在问题仪表板和仓库的问题页面上，根据字段值过滤和搜索问题。在搜索栏中，键入 field.，后跟字段名称和数值。例如

• field.priority:high 用于查找优先级设为 “high” 的问题
• field."target date":>=2026-03-01 用于查找目标日期在 2026 年 3 月 1 日或之后的问题
• field.priority:high,medium 用于查找优先级设为 “high” 或 “medium” 的问题

欲了解更多信息，请参阅 过滤和搜索问题与拉取请求。

使用 API 操作问题字段

问题字段完整支持 REST 和 GraphQL API。您可以自动化字段管理、以编程方式设置值，并与外部工具集成。

• 管理字段：创建、更新和删除组织级字段。参见 组织问题字段 REST API。
• 使用字段：获取、设置和清除单个问题的字段值。参见 问题字段值 REST API。
• GraphQL：问题字段类型和变更同样可通过 GraphQL 使用。参见 IssueFields 联合体、问题字段对象（如 IssueFieldText、IssueFieldSingleSelect、IssueFieldNumber 和 IssueFieldDate）以及 变更（如 createIssueField、updateIssueField 和 setIssueFieldValue）。