# GitHub Issues 快速入门 按照此简短的交互式指南了解 GitHub Issues。 ## 简介 本指南演示如何用于 GitHub Issues 规划和跟踪一部分工作。 在本指南中，你将创建一个新问题 并将其分解为子问题。 你还将了解如何添加标签、问题类型、里程碑、分配者和项目，以传达有关问题的元数据。 ## 先决条件 要创建议题，您需要一个仓库。 您可以使用您有写入权限的现有仓库，或者创建一个新的仓库。 存储库必须启用问题。 有关创建存储库的详细信息，请参阅 [创建新仓库](/zh/repositories/creating-and-managing-repositories/creating-a-new-repository)。 有关在仓库中禁用问题时如何启用，详见 [禁用议题](/zh/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues)。 ## 打开空白议题 首先，创建议题。 创建议题的方法有很多种：您可以为工作流程选择最方便的方法。 此示例将使用 GitHub UI。 有关创建问题的其他方法的详细信息，请参阅“[创建议题](/zh/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)”。 1. 在 GitHub 上，导航到存储库的主页面。 2. 在仓库名称下，单击 “Issues”\*\*\*\*。 ![存储库的主页的屏幕截图。 在水平导航栏中，标记有“问题”的选项卡以深橙色标出。](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png) 3. 单击“新建问题”。 4. 在此示例中，我们将从空白议题开始。 存储库可以使用问题模板 和问题表单 来鼓励参与者提供特定信息。 如果存储库使用问题模板，请单击“打开空白问题”。 ## 填写信息 为议题提供一个描述性标题。 标题应一目了然地传达议题的内容。 添加解释问题目的之说明，包括任何可能有助于解决问题的详细信息。 例如，如果这是漏洞报告，请描述重现漏洞的步骤、预期结果和实际结果。 您可以使用 Markdown 添加格式、链接、表情等内容。 有关详细信息，请参阅“[在 GitHub 上写入](/zh/get-started/writing-on-github)”。 ![新问题表单的屏幕截图，显示已填写的标题和正文。](/assets/images/help/issues/issue-title-body.png) ## 添加任务列表 还可以使用纯文本来跟踪没有相应议题的任务，并在以后将其转换为议题。 有关详细信息，请参阅“[关于任务列表](/zh/get-started/writing-on-github/working-with-advanced-formatting/about-tasklists)”。 ![新问题表单的屏幕截图，其中填写了标题和正文。 正文包括任务列表的 Markdown 内容。](/assets/images/help/issues/issue-task-list-raw.png) ## 分配议题 要传达责任，您可以将议题分配给您的组织成员。 请参阅“[向其他GitHub用户分配问题和拉取请求](/zh/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users)”。 ![新议题表单的屏幕截图。 在右侧边栏中，“被分派人”部分以深橙色框出。](/assets/images/help/issues/issue-assignees.png) ## 添加标签 将标签添加到问题以进行分类。 例如，可使用 `question` 标签和 `good first issue` 标签来指示某个议题是首次参与者可能发现的问题。 用户可以通过标签过滤议题，以查找所有具有特定标签的议题。 您可以使用默认标签，也可以创建新标签。 有关详细信息，请参阅“[管理标签](/zh/issues/using-labels-and-milestones-to-track-work/managing-labels)”。 ![新议题表单的屏幕截图。 在右侧边栏中，“标签”部分以深橙色框出。](/assets/images/help/issues/issue-with-label.png) ## 添加议题类型 可以添加议题类型以对整个组织中的工作进行分类。 请参阅“[管理组织中的问题类型](/zh/issues/tracking-your-work-with-issues/using-issues/managing-issue-types-in-an-organization)”。 ![新议题表单的屏幕截图。 在右侧边栏中，“Type”部分以深橙色框出。](/assets/images/help/issues/issue-type.png) ## 将议题添加到项目中 可将问题添加到现有项目，并为项目填充元数据。 有关项目的详细信息，请参阅 [关于 Projects](/zh/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)。 ![新议题表单的屏幕截图。 在右侧边栏中，“项目”部分以深橙色框出。](/assets/images/help/issues/issue-project.png) ## 添加里程碑 您可以添加里程碑来跟踪议题，作为基于日期的目标的一部分。 随着目标日期的临近，里程碑将显示议题的进度。 请参阅“[关于里程碑](/zh/issues/using-labels-and-milestones-to-track-work/about-milestones)”。 ![新议题表单的屏幕截图。 在右侧边栏中，“里程碑”部分以深橙色框出。](/assets/images/help/issues/issue-milestone.png) ## 提交您的问题 单击“提交新问题”以创建问题。 您可以在创建议题后编辑任何上述字段。 您的议题具有独特的 URL，可以与团队成员共享，或在其他议题或拉取请求中引用。 ## 添加子问题 可以向议题添加子议题，以便快速将较大的工作分解为较小的议题。 子问题通过创建问题之间的关系，增加了对 GitHub 上的问题层次结构的支持。 可以创建多个层次结构级别，通过将任务精确地分解为你和你的团队所需的细节量来准确表示项目。 请参阅 [添加子问题](/zh/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues) 和 [浏览子问题](/zh/issues/tracking-your-work-with-issues/using-issues/browsing-sub-issues)。 ![问题说明下方的子问题部分的屏幕截图。 “查看更多子问题选项”按钮以橙色矩形突出显示。](/assets/images/help/issues/sub-issue-drop-down.png) ## 添加问题依赖项 可以使用议题依赖项来定义议题之间的阻止关系。 通过议题依赖项，可以识别被其他工作阻止或阻止其他工作的议题。 请参阅“[创建问题依赖项](/zh/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies)”。 ## 沟通 创建议题后，通过向议题添加评论来继续对话。 可以 @mention 协作者或团队以提醒他们注意评论。 要链接同一存储库中的相关问题，可以键入 `#`，后接问题标题的一部分，然后单击要链接的问题。 有关详细信息，请参阅“[在 GitHub 上写入](/zh/get-started/writing-on-github)”。 ![问题注释的屏幕截图。 标题显示“octocat 现在评论”，正文显示“@hubot 我们还需要更新 Rocket 逻辑吗？”](/assets/images/help/issues/issue-comment.png) ## 后续步骤 您可以将议题用于广泛的用途。 例如： * 跟踪想法 * 收集反馈 * 规划任务 * 报告错误 若要将问题分解为更易于管理的任务，可以添加多个级别的子问题。 请参阅“[添加子问题](/zh/issues/tracking-your-work-with-issues/using-issues/adding-sub-issues)”。 以下是一些有助于你借助 GitHub Issues 继续下一步的资源： * 若要了解有关问题的详细信息，请参阅“[关于问题](/zh/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)”。 * 若要了解使用 GitHub“规划和跟踪工具”的基本知识，请参阅 [为您的团队或项目规划和跟踪工作](/zh/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project)。 * 若要详细了解项目如何帮助你进行规划和跟踪，请参阅 [了解 Projects](/zh/issues/planning-and-tracking-with-projects/learning-about-projects)。 * 若要详细了解如何使用问题模板 和问题表单 来鼓励参与者提供特定信息，请参阅 [使用模板鼓励有用的议题和拉取请求](/zh/communities/using-templates-to-encourage-useful-issues-and-pull-requests)。