添加子问题

了解如何使用子问题将工作分解为任务。

谁可以使用此功能？

People with at least triage permissions for a repository can add sub-issues.

在本文中

可以向问题添加子问题，将较大的工作分解为任务。 子问题显示它们与父问题的关系，使你能够跟踪你的工作。GitHub 父问题和子问题进度也可在您的 项目 中使用，从而让您创建视图、进行筛选并按父问题分组。

子问题本身可以包含子问题，使你可以创建完整的问题层次结构，该层次结构可视化整个项目或工作片段并显示问题之间的关系。

每个父问题最多可添加 100 个子问题，并且最多可创建八级嵌套子问题。

创建子问题

  1. 导航到要添加子问题的问题。
  2. 在问题说明的底部，单击“创建子问题”。
  3. 在对话框中，键入子问题的标题。
  4. （可选）键入问题说明，并设置 问题类型和 任何被分配者、标签、项目和里程碑。
  5. （可选）如果要继续为此父问题创建子问题，请选择“创建更多子问题”。
  6. 单击 “创建” 。

将现有问题添加为子问题

  1. 导航到要添加子问题的问题。

  2. 在问题说明的底部，单击“创建子问题”旁边的“ 创建子问题”。

    问题说明下方的子问题部分的屏幕截图。 “查看更多子问题选项”按钮以橙色矩形突出显示。

  3. 在下拉菜单中，单击“添加现有问题”。

  4. 选择要添加为子问题的问题。

    • 从其中一项建议中选择问题。
    • 在“搜索问题”字段中，键入问题标题或问题编号，然后单击结果。
    • 若要添加来自其他存储库的问题，请单击 存储库名称旁边的并选择其他存储库。

使用 GitHub CLI 处理子问题

GitHub CLI 是用于从计算机的命令行使用 GitHub 的开源工具。 从命令行操作时，您可以使用 GitHub CLI 来节省时间并避免切换上下文。 若要了解详细信息 GitHub CLI，请参阅 关于 GitHub CLI。

若要将新议题创建为现有父议题的子议题，请使用 --parent 标志并配合 gh issue create。 父项可以通过问题编号或 URL 指定。

gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER

若要将现有问题添加为父问题的子问题，请使用 --add-sub-issue 标志并搭配 gh issue edit。 该标志接受以逗号分隔的问题编号或 URL 列表。

gh issue edit PARENT-ISSUE-NUMBER --add-sub-issue SUB-ISSUE-NUMBER

若要将子问题从其父问题中移除，请在父问题上使用 --remove-sub-issue，或在子问题上使用 --remove-parent。

gh issue edit PARENT-ISSUE-NUMBER --remove-sub-issue SUB-ISSUE-NUMBER
gh issue edit SUB-ISSUE-NUMBER --remove-parent