Skip to main content

关于任务列表

您可以使用任务列表将议题或拉取请求的工作分解为较小的任务,然后跟踪要完成的整套工作。

谁可以使用此功能?

Markdown 可用于 GitHub Web 界面。

关于任务列表

任务列表是一组任务,每个任务都在单独的行上呈现,带有可点击的复选框。 您可以选中或取消选中复选框来将任务标记为完成或未完成。

您可以使用 Markdown 在 GitHub 上的任何评论中创建任务列表。 如果在列表中引用议题、拉取请求或讨论,则引用将展开以显示标题和状态。

关于议题任务列表

如果您将任务列表添加到议题正文中,列表具有添加的功能。

  • 为了帮助您跟踪团队在议题上的操作,议题任务列表的进度出现在 GitHub 的不同位置,例如仓库的议题列表。
  • 如果任务引用另一个议题,并且有人关闭该议题,则任务的复选框将自动标记为完整。
  • 如果任务需要进一步跟踪或讨论,您可以通过在任务上方悬停并单击任务右上角的 将任务转换为议题。 要在创建议题之前添加更多详细信息,您可以使用键盘快捷方式打开新议题表单。 有关详细信息,请参阅“键盘快捷方式”。
  • 任务列表中提及的任何议题都将指定在引用议题中跟踪它们。

GitHub 问题的屏幕截图,其中显示了标题“功能”下的任务列表。 某些项目被选中(状态为已完成),而其他项目未选中(状态为未完成)。 三个列表项链接到其他 GitHub Issues。

创建任务列表

若要创建任务列表,请在列表项前加连字符和空格,后接 [ ]。 要将任务标记为完成,请使用 [x]

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

显示 Markdown 的呈现版本的屏幕截图。 对问题的引用呈现为问题标题。

Tip

不能在已关闭的问题或包含链接的拉取请求的问题中创建任务列表项。

对任务重新排序

你可以对任务列表中的项重新排序。 首先,单击或将鼠标悬停在任务复选框左侧,直到出现六个点的网格。 然后,拖放网格,将任务移动到新位置。

可以在相同的注释中对不同列表中的任务重新排序,但是不能在不同的注释中重新排序任务。

GitHub 问题的屏幕截图,其中显示了任务列表中的两个任务。 第二个任务左侧的六个点网格用深橙色框出。

将任务转换为问题

也可以将任务转换为问题。 首先,将鼠标悬停在任务列表中的某个项上,然后单击

GitHub 问题的屏幕截图,其中显示了两个任务。 “转换为问题”图标以橙色轮廓突出显示。

任务列表中引用的任何议题都指定它们被包含任务列表的议题跟踪。 要从已跟踪的议题导航到正在跟踪的议题,请单击议题状态旁边的“已跟踪”中的跟踪议题编号。

名为“创建问题之间的关系”的 GitHub 问题和问题 #3 的屏幕截图。 问题标题下方显示为“由问题 #2 跟踪”的一个按钮用深橙色框出。

其他阅读材料