Skip to main content

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

GitHub Issues 快速入门

按照这个简短的互动指南了解 GitHub Issues。

简介

本指南说明如何使用 GitHub Issues 来规划和跟踪一项工作。 在此指南中,您将创建新议题并添� 任务列表以跟踪子任务。 您还将学� 如何添� � �签、里程碑、受理人和项目来� 达有关您的议题的元数据。

先决条件

要创建议题,您需要一个仓库。 您可以使用您有写入权限的现有仓库,或者创建一个新的仓库。 存储库必须启用议题。 有关创建存储库的详细信息,请参阅“新建存储库”。 有关启用存储库中已禁用的问题的详细信息,请参阅“禁用问题”。

打开空白议题

首先,创建议题。 创建议题的方法有很多种:您可以为工作流程选择最方便的方法。 此示例将使用 GitHub UI。 有关创建问题的其他方法的详细信息,请参阅“问题”。

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository. 2. 在存储库名称下,单击 “问题”。 议题选项卡 1. 单击“新建问题”。 “新建问题”按钮
  2. 在此示例中,我们将从空白议题开始。 存储库可能使用问题模板来鼓励参与者提供具体信息。 如果存储库使用问题模板,请单击“打开空白问题” 。

空白议题

填写信息

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

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

您可以使用 Markdown 添� � �式、链接、表情等内容。 有关详细信息,请参阅“在 GitHub 上编写”。

议题� �题和正文

添� 任务列表

将大问题分解为较小的任务,或在单个较大的问题中跟踪多个相关问题,可能会有所帮助。 使用 [ ] 预置列表项,将任务列表添� 到问题。 按议题编号或 URL 引用现有议题。 您可以使用纯文本来跟踪没有相应议题的任务,并在以后将其转换为议题。 有关详细信息,请参阅“关于任务列表”。

带任务列表的议题

添� � �签

添� � �签对议题分类。 例如,可使用 bug � �签和 good first issue � �签来指示某个问题是首次参与者可能发现的漏洞。 用户可以通过� �签过滤议题,以查找所有具有特定� �签的议题。

您可以使用默认� �签,也可以创建新� �签。 有关详细信息,请参阅“管理� �签”。

带� �签的议题

添� 里程碑

您可以添� 里程碑来跟踪议题,作为基于日期的目� �的一部分。 随着目� �日期的临近,里程碑将显示议题的进展。 有关详细信息,请参阅“关于里程碑”。

有里程碑的议题

分配议题

要� 达责任,您可以将议题分配给您的组织成员。 有关详细信息,请参阅“向其他 GitHub 用户分配问题并拉取请求”。

有受理人的议题

添� 议题到项目

可将问题添� 到现有项目 有关项目的详细信息,请参阅“使用项目板组织工作”。

有项目的议题

提交议题

单击“提交新问题”以创建问题。 您可以在创建议题后编辑任何上述字段。 您的议题具有独特的 URL,可以与团队成员共享,或在其他议题或拉取请求中引用。

通信

创建议题后,通过向议题添� 评论来继续对话。 可以 @mention 协作者或团队以提醒他们注意评论。 要链接同一存储库中的相关问题,可以键入 #,后接问题� �题的一部分,然后单击要链接的问题。 有关详细信息,请参阅“在 GitHub 上编写”。

议题评论

后续步骤

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

  • 跟踪想法
  • 收集反馈
  • 规划任务
  • 报告 Bug

以下是一些帮助� 对 GitHub Issues 执行后续步骤的有用资源: