关于问题

了解如何使用 GitHub Issues 跟踪想法、反馈、任务或缺陷。

在本文中

可以在存储库中创建问题来规划、讨论和跟踪工作。 问题可以快速创建，并且非常灵活，可以以多种方式使用。 议题可用于跟踪缺陷报告、新功能和想法，以及任何其他需要记录下来或与团队讨论的内容，你还可以使用 项目 来为团队规划工作并跟踪进度。 还可以通过添加子问题并轻松浏览要完成的完整工作层次结构来进一步分解工作。

议题可以通过多种方式创建，因此您可以为工作流程选择最方便的方法。 例如，可以从存储库创建问题，同时添加子问题、在问题或拉取请求中转换注释、从特定代码行或 URL 查询创建问题。 还可以从所选平台创建问题：通过 Web UI、 GitHub Desktop、 GitHub CLIGraphQL 和 REST API，或者 GitHub Mobile。 请参阅“创建议题”。

关于子问题

可以向议题添加子议题，以便快速将较大的工作分解为较小的议题。 子问题通过创建问题之间的关系，增加了对 GitHub 上的问题层次结构的支持。 可以创建多个层次结构级别，通过将任务精确地分解为你和你的团队所需的细节量来准确表示项目。 请参阅 添加子问题 和 浏览子问题。

关于问题依赖项

可以使用议题依赖项来定义议题之间的阻止关系。 通过议题依赖项，可以识别被其他工作阻止或阻止其他工作的议题。 请参阅“创建问题依赖项”。

有关议题的元数据

可以将元数据添加到问题，包括 问题类型、 标签和里程碑，以组织问题。

请参阅 管理组织中的问题类型、 管理标签 和 关于里程碑。

关于与 GitHub 的集成

问题与你整个 GitHub 上的工作集成。 在另一个问题或拉取请求中提及问题将创建它们之间的引用，而且在拉取请求中使用关键字（例如 fixes:）将自动关闭关联的问题。 请参阅“将拉取请求链接到议题”。

使用 项目 规划和跟踪你的工作

项目 与问题紧密集成，以规划和跟踪团队的工作。 所有问题元数据都在项目中可用，使你可以创建视图和筛选器来表示工作。 请参阅“关于 Projects”。

保持更新

为保持更新议题中的最新评论，您可以订阅议题以接收关于最新评论的通知。 要快速查找指向您订阅的最新议题的链接，请访问仪表板。 有关详细信息，请参阅 关于通知 和 个人仪表板快速入门。

可以将自己和团队成员分配到问题，以明确谁正在处理问题，并使你更容易找到问题。 请参阅“向其他GitHub用户分配问题和拉取请求”和“查看所有问题和拉取请求”。

社区管理

为了帮助参与者打开提供所需信息有意义的问题，可以使用 问题表单和 问题模板。 请参阅“使用模板鼓励有用的议题和拉取请求”。

若要维护健康的社区，可以报告违反 GitHub“ 社区准则”的评论。 请参阅 举报滥用或垃圾邮件。

高效沟通

你可以在议题中 @mention 能访问你的存储库的协作者，以提请他们注意评论。 要链接同一存储库中的相关问题，可以键入 #，后接问题标题的一部分，然后单击要链接的问题。 为了沟通责任，您可以分配议题。 如果您发现自己经常输入相同的评论，可以使用已保存的回复。

请参阅 基本写作和格式语法 和 向其他GitHub用户分配问题和拉取请求。

比较问题和讨论

有些对话更适合通过 GitHub Discussions 进行。 您可以使用 GitHub Discussions 来提问和回答问题、共享信息、发布公告以及进行或参与有关项目的对话。 有关详细信息，请参阅“关于讨论”。 有关何时使用问题或讨论的指导，请参阅 在GitHub上交流。

当某个议题中的对话更适合讨论时，您可以将议题转换为讨论。

后续步骤

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