{"meta":{"title":"关于任务列表","intro":"你可以使用任务列表将议题或拉取请求的工作分解为较小的任务，然后跟踪要完成的整套工作。","product":"开始","breadcrumbs":[{"href":"/zh/get-started","title":"开始"},{"href":"/zh/get-started/writing-on-github","title":"在 GitHub 上写入"},{"href":"/zh/get-started/writing-on-github/working-with-advanced-formatting","title":"使用高级格式"},{"href":"/zh/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists","title":"关于任务列表"}],"documentType":"article"},"body":"# 关于任务列表\n\n你可以使用任务列表将议题或拉取请求的工作分解为较小的任务，然后跟踪要完成的整套工作。\n\n## 关于任务列表\n\n> \\[!IMPORTANT]\n> 任务列表块已被停用\"退休\"。 你可以在 [GitHub 博客](https://github.blog/changelog/2025-02-18-github-issues-projects-february-18th-update/)上了解更多相关信息。\n>\n> 你可以使用子议题来替代任务列表块。 子议题会在每个议题中提供一个专用部分，使你无需依赖 Markdown 也能更方便地跟踪相关工作。 有关子议题的详细信息，请参阅“[添加子问题](/zh/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)”。\n\n任务列表是一组任务，每个任务都在单独的行上呈现，带有可单击的复选框。 您可以选中或取消选中复选框来将任务标记为完成或未完成。\n\n可以使用 Markdown 在 GitHub 上的任何评论中创建任务列表。 如果在任务列表中引用议题、拉取请求或讨论，则引用将展开以显示标题和状态。\n\n## 关于议题任务列表\n\n如果将任务列表添加到议题正文中，则列表将具有添加的功能。\n\n* 为了帮助你跟踪团队在议题上的操作，议题任务列表的进度会显示在 GitHub 上的各个位置，例如仓库的议题列表。\n* 如果任务引用另一个议题，并且有人关闭该议题，则任务的复选框将自动标记为完整。\n* 如果任务需要进一步跟踪或讨论，您可以通过在任务上方悬停并单击任务右上角的 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-issue-opened\" aria-label=\"The issue opened icon\" role=\"img\"><path d=\"M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z\"></path></svg> 将任务转换为议题。 要在创建议题之前添加更多详细信息，您可以使用键盘快捷方式打开新议题表单。 有关详细信息，请参阅“[键盘快捷方式](/zh/get-started/accessibility/keyboard-shortcuts#issues-and-pull-requests)”。\n* 任务列表中提及的任何问题都将指定在引用问题中跟踪它们。\n\n![显示标题“功能”下任务列表问题的屏幕截图。 三个列表项链接到其他议题。](/assets/images/help/writing/task-list-rendered.png)\n\n## 创建任务列表\n\n若要创建任务列表，请在列表项前加连字符和空格，后接 `[ ]`。 要将任务标记为完成，请使用 `[x]`。\n\n```markdown\n- [x] #739\n- [ ] https://github.com/octo-org/octo-repo/issues/740\n- [ ] Add delight to the experience when all tasks are complete :tada:\n```\n\n![显示 Markdown 的呈现版本的屏幕截图。 对问题的引用呈现为问题标题。](/assets/images/help/writing/task-list-rendered-simple.png)\n\n> \\[!NOTE]\n> 不能在已关闭的问题或包含链接的拉取请求的问题中创建任务列表项。\n\n## 对任务重新排序\n\n你可以对任务列表中的项重新排序。 首先，单击或将鼠标悬停在任务复选框左侧，直到出现六个点的网格。 然后，拖放网格，将任务移动到新位置。\n\n可以在相同的注释中对不同列表中的任务重新排序，但是不能在不同的注释中重新排序任务。\n\n![GitHub 问题的屏幕截图，显示了任务列表中的两个任务。 第二个任务左侧的六个点网格用深橙色框出。](/assets/images/help/writing/task-list-reorder.png)\n\n## 将任务转换为问题\n\n也可以将任务转换为问题。 首先，将鼠标悬停在任务列表里的某个项目上，然后单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-issue-opened\" aria-label=\"Convert to issue\" role=\"img\"><path d=\"M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path><path d=\"M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z\"></path></svg>。\n\n![显示两个任务的议题的屏幕截图。 “Convert to issue”图标以橙色轮廓突出显示。](/assets/images/help/writing/convert-task-lists-into-issues.png)\n\n## 导航跟踪的议题\n\n任务列表中引用的任何问题都指定它们被包含任务列表的问题跟踪。 要从已跟踪的议题导航到正在跟踪的议题，请单击议题状态旁边的“Tracked by”部分中的跟踪议题编号\\*\\*\\*\\*。\n\n![问题 3 的屏幕截图，其中显示了“Open”问题状态和“由问题 #2 跟踪”文本（以橙色轮廓显示）。](/assets/images/help/writing/task-list-tracked.png)"}