Skip to main content
Skip to content

关于任务列表

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

谁可以使用此功能?

Markdown 可用于 GitHub Web 界面。

关于任务列表

重要

任务列表块为 退休. 可以在博客上GitHub阅读有关此内容的详细信息。

可以使用子问题作为任务列表块的替代项。 子议题会在每个议题中提供一个专用部分,使你无需依赖 Markdown 也能更方便地跟踪相关工作。 有关子议题的详细信息,请参阅“添加子问题”。

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

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

关于议题任务列表

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

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

显示标题“功能”下任务列表问题的屏幕截图。 三个列表项链接到其他议题。

创建任务列表

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

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

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

注意

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

对任务重新排序

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

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

GitHub 议题的截图,显示任务列表中的两项任务。 第二个任务左侧一个由六个点组成的网格以深橙色描边。

将任务转换为问题

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

显示两个任务的议题的屏幕截图。 “Convert to issue”图标以橙色轮廓突出显示。

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

问题 3 的屏幕截图,其中显示了“Open”问题状态和“由问题 #2 跟踪”文本(以橙色轮廓显示)。