# GitHub Issues 快速入门

按照此简短的交互式指南了解 GitHub Issues。

## 简介

本指南演示如何用于 GitHub Issues 规划和跟踪一部分工作。 在本指南中，你将创建一个新问题。 你还将了解如何添加标签、里程碑、分配者和项目，以传达有关问题的元数据。

## 先决条件

要创建议题，您需要一个仓库。 您可以使用您有写入权限的现有仓库，或者创建一个新的仓库。
存储库必须启用问题。 有关创建存储库的详细信息，请参阅 [创建新仓库](/zh/enterprise-server@3.17/repositories/creating-and-managing-repositories/creating-a-new-repository)。 有关在仓库中禁用问题时如何启用，详见 [禁用议题](/zh/enterprise-server@3.17/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues)。

## 打开空白议题

首先，创建议题。 创建议题的方法有很多种：您可以为工作流程选择最方便的方法。 此示例将使用 GitHub UI。 有关创建问题的其他方法的详细信息，请参阅“[创建议题](/zh/enterprise-server@3.17/issues/tracking-your-work-with-issues/using-issues/creating-an-issue)”。

1. 在 GitHub 上，导航到存储库的主页面。
2. 在仓库名称下，单击 <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" 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>“Issues”\*\*\*\*。

   ![存储库的主页的屏幕截图。 在水平导航栏中，标记有“问题”的选项卡以深橙色标出。](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)
3. 单击“新建问题”。
4. 在此示例中，我们将从空白议题开始。 存储库可以使用问题模板 来鼓励参与者提供特定信息。 如果存储库使用问题模板，请单击“打开空白问题”。

## 填写信息

为议题提供一个描述性标题。 标题应一目了然地传达议题的内容。

添加解释问题目的之说明，包括任何可能有助于解决问题的详细信息。 例如，如果这是漏洞报告，请描述重现漏洞的步骤、预期结果和实际结果。

您可以使用 Markdown 添加格式、链接、表情等内容。 有关详细信息，请参阅“[在 GitHub 上写入](/zh/enterprise-server@3.17/get-started/writing-on-github)”。

![新问题表单的屏幕截图，显示已填写的标题和正文。](/assets/images/help/issues/issue-title-body.png)

## 添加问题依赖项

可以使用议题依赖项来定义议题之间的阻止关系。 通过议题依赖项，可以识别被其他工作阻止或阻止其他工作的议题。 请参阅“[创建问题依赖项](/zh/issues/tracking-your-work-with-issues/using-issues/creating-issue-dependencies)”。

## 沟通

创建议题后，通过向议题添加评论来继续对话。 可以 @mention 协作者或团队以提醒他们注意评论。 要链接同一存储库中的相关问题，可以键入 `#`，后接问题标题的一部分，然后单击要链接的问题。 有关详细信息，请参阅“[在 GitHub 上写入](/zh/enterprise-server@3.17/get-started/writing-on-github)”。

![问题注释的屏幕截图。 标题显示“octocat 现在评论”，正文显示“@hubot 我们还需要更新 Rocket 逻辑吗？”](/assets/images/help/issues/issue-comment.png)

## 后续步骤

您可以将议题用于广泛的用途。 例如：

* 跟踪想法
* 收集反馈
* 规划任务
* 报告错误

以下是一些有助于你借助 GitHub Issues 继续下一步的资源：

* 若要了解有关问题的详细信息，请参阅“[关于问题](/zh/enterprise-server@3.17/issues/tracking-your-work-with-issues/learning-about-issues/about-issues)”。
* 若要了解使用 GitHub“规划和跟踪工具”的基本知识，请参阅 [为您的团队或项目规划和跟踪工作](/zh/enterprise-server@3.17/issues/tracking-your-work-with-issues/learning-about-issues/planning-and-tracking-work-for-your-team-or-project)。
* 若要详细了解项目如何帮助你进行规划和跟踪，请参阅 [了解 Projects](/zh/enterprise-server@3.17/issues/planning-and-tracking-with-projects/learning-about-projects)。
* 若要详细了解如何使用问题模板 来鼓励参与者提供特定信息，请参阅 [使用模板鼓励有用的议题和拉取请求](/zh/enterprise-server@3.17/communities/using-templates-to-encourage-useful-issues-and-pull-requests)。