# 添加和管理问题字段

可以针对各个问题设置、编辑和清除问题字段值，以捕获团队的结构化元数据。

问题字段显示在问题的右侧边栏中，随之显示的还有系统字段，如代理人、标签和类型。 可以在创建或编辑问题时设置值。 在创建问题时选择问题类型时，与该类型关联的字段将自动显示在侧边栏中。

> \[!NOTE]
> 问题字段当前仅在问题上可用。 拉取请求不支持议题字段。

## 设置字段值

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

> \[!NOTE]
> 问题字段当前无法通过 URL 查询参数预先填充，也不能通过问题模板进行设置。 若要设置字段值，请使用问题边栏、项目、API 或 GitHub Actions。

## 编辑字段值

1. 导航到问题。
2. 在右侧栏中，单击要更改的字段值。
3. 选择新值或键入新条目。
4. 更改会自动保存。

## 清除字段值

1. 导航到问题。
2. 在右侧栏中，单击该字段的值。
3. 清除值：
   * 对于 **单选** 字段，请单击当前选择的选项以取消选中它。
   * 对于 **文本** 和 **数字** 字段，请删除输入中的所有文本。
   * 对于 **日期** 字段，请单击日期选取器中的清除按钮。
4. 清除后，字段将从边栏中删除。 可以使用 **“添加字段** ”按钮重新添加它。

## 固定的字段

如果组织管理员已将字段固定到特定的问题类型，则在创建或查看该类型的问题时，这些字段会自动显示在侧边栏和问题创建弹窗中。 无需手动添加固定字段。

## 在时间线上查看字段更改

更改字段值后，更新将记录在问题时间线中。 时间线条目显示：

* 更改了哪个字段
* 已设置的新值
* 做出更改的人员
* 进行更改的时间

若用户不是组织成员或协作者，则看不到设置为“仅组织”可见性的字段的时间线事件。

## 字段可见性

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

* 如果字段设为**仅限组织**，则只有至少具有读取访问权限的组织成员以及存储库协作者可以查看。 如果你不是成员或协作者，则字段不会出现在问题边栏、时间线或搜索建议中。
* 如果字段设置为 **“公共**”，则任何查看问题的人都可以看到该字段。

有关配置可见性的详细信息，请参阅 [管理组织中的问题字段](/zh/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility)。

## 在项目中使用问题字段

可以将问题字段添加为项目视图中的列，可在其中编辑值、分组、筛选、排序和生成图表。 有关详细信息，请参阅“[关于项目中的问题字段](/zh/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields)”。

## 按字段值搜索

可以根据问题仪表板和存储库问题页中的字段值筛选和搜索问题。 在搜索栏中，键入 `field.` 后跟字段名称和值。 例如：

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

有关详细信息，请参阅“[筛选和搜索议题以及拉取请求](/zh/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)”。

## 在 API 中使用问题字段

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

* **管理字段**：创建、更新和删除组织级字段。 请参阅 [“组织问题”字段 REST API](/zh/rest/orgs/issue-fields)。
* **使用字段**：获取、设置和清除单个问题的字段值。 请参阅[“问题”字段值 REST API](/zh/rest/issues/issue-field-values)。
* **GraphQL**：问题字段类型和突变也可通过 GraphQL 获得。 请参阅[`IssueFields` 联合](/zh/graphql/reference/issues#union-issuefields)、[问题字段对象](/zh/graphql/reference/issues#object-issuefieldtext)（如 `IssueFieldText`、`IssueFieldSingleSelect`、`IssueFieldNumber` 和 `IssueFieldDate`）和[突变](/zh/graphql/reference/issues#mutation-createissuefield)（如 `createIssueField`、`updateIssueField` 和 `setIssueFieldValue`）。

## 使用 GitHub Actions 实现自动化

问题字段更改会在 `issues` 事件时触发 Webhook 事件。 可以使用这些触发器作为工作流触发器：

* `field_added`：设置或更新字段值时触发。
* `field_removed`：字段值被清空时触发。

例如，每当字段值更改时运行工作流：

```yaml
on:
  issues:
    types: [field_added, field_removed]
```

事件有效负载包括字段名称、类型、值和上一个值。 有关详细信息，请参阅“[触发工作流的事件](/zh/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)”。