关于任务列表

你可以使用任务列表将问题或拉取请求的工作分解为更小的任务，然后跟踪整套工作的完成情况。

本文内容

注意：有关当前处于测试阶段的任务列表的新迭代的更多信息，请参阅“创建任务列表”。

关于任务列表

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

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

关于问题任务列表

如果你在问题的正文中添加任务列表，该列表将具有添加的功能。

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

Screenshot of a GitHub issue showing a task list under the header "Features." Some items are checked as done, others unchecked as undone. Three list items link to other 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:

Screenshot showing the rendered version of the markdown. The references to issues are rendered as issue titles.

提示：你无法在已关闭的问题或具有链接拉取请求的问题中创建任务列表项。

重新排序任务

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

你可以在同一评论中的不同列表之间重新排序任务，但不能在不同评论之间重新排序任务。

Screenshot of a GitHub issue showing two tasks in a task list. A grid of six dots to the left of the second task is outlined in dark orange.

将任务转换为问题

你还可以将任务转换为问题。首先，将鼠标悬停在任务列表中的其中一项上，然后单击 .

Screenshot of a GitHub issue showing two tasks. The"Convert to issue" icon is highlighted with an orange outline.

任务列表中引用的任何问题都指定它们由包含任务列表的问题跟踪。要从跟踪问题导航到跟踪问题，请单击问题状态旁边的在其中跟踪部分中的跟踪问题编号。

Screenshot of a GitHub issue named "Create relationships between issues" and numbered issue 3. A button below the issue title reading "Tracked by issue #2" is outlined in dark orange.

延伸阅读