Skip to main content

创建议题

议题可以通过多种方式创建,因此您可以为工作流程选择最方便的方法。

谁可以使用此功能?

People with read access can create an issue in a repository where issues are enabled.

议题可用于跟踪漏洞、增强功能或其他请求。 有关详细信息,请参阅“关于议题”。

仓库管理员可以禁用仓库的议题。 有关详细信息,请参阅“禁用议题”。

从仓库创建议题

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在仓库名称下,单击 “Issues”****。

    存储库的主页的屏幕截图。 在水平导航栏中,标记有“问题”的选项卡以深橙色标出。

  3. 单击“新建问题”。

  4. 如果你的存储库使用问题模板,请在要打开的问题类型旁边单击“开始”。

    如果要打开的问题类型未包含在可用选项中,请单击“打开空白问题”。

    问题的模板选择器的屏幕截图。 在模板选项下方,标记为“打开空白问题”的链接以深橙色突出显示。

  5. 在“标题”字段中键入问题标题。

  6. 在注释正文字段中键入问题的说明。

  7. 如果你是项目维护者,可以将问题分配给某人将其添加到 项目将其与里程碑关联设置问题类型、或应用标签

  8. 完成后,单击“提交新问题”。

使用 GitHub CLI

创建议题

GitHub CLI 是用于从计算机的命令行使用 GitHub 的开源工具。 从命令行操作时,您可以使用 GitHub CLI 来节省时间并避免切换上下文。 若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

若要创建问题,请使用 gh issue create 子命令。 若要跳过交互式提示,请添加 --body 标志和 --title 标志。

gh issue create --title "My new issue" --body "Here are more details."

您还可以指定受理人、标签、里程碑和项目。

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

从评论创建议题

您可以从议题或拉取请求中的评论打开新议题。 从评论打开议题时,该议题包含一个代码段,显示评论的原始发布位置。

  1. 导航到您要从中打开议题的评论。

  2. 在该评论中,单击

    对拉取请求的评论的屏幕截图。 “烤肉串”按钮以深橙色标出。

  3. 单击“新问题中的引用”。

  4. 使用“存储库”下拉菜单,并选择要在其中打开问题的存储库。

  5. 键入议题的描述性标题和正文。

  6. 单击“创建问题”。

  7. 如果你是项目维护者,可以将问题分配给某人将其添加到 项目将其与里程碑关联设置问题类型、或应用标签

  8. 完成后,单击“提交新问题”。

从代码创建议题

您可以从文件或拉取请求的特定代码行打开新议题。 从代码打开议题时,议题包含小片段,其中显示所选代码的行或范围。 只能打开存储代码的仓库中的议题。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 找到要在议题中引用的代码:

    • 要打开文件中代码相关的议题,请找到该文件。
    • 要打开拉取请求中代码相关的议题,请导航到该拉取请求并单击“ Files changed”****。 然后浏览到含有要包含在评论中的代码的文件,并单击“查看”。
  3. 决定是选择一行还是一个范围。

    • 要选择单行代码,请单击行号以高亮显示该行。
    • 要选择代码范围,请单击范围内第一行的行号以高亮显示代码行。 然后,将鼠标停在代码范围的最后一行,按 Shift,再单击行号以突出显示范围。
  4. 在代码范围左侧,单击 。 在下拉菜单中,单击“新问题中的引用”。

    一个文件的屏幕截图,其中选中了 8 行。 在第一个选定行的左侧,一个标有“烤肉串”图标的按钮以深橙色标出。

  5. 在“标题”字段中键入问题标题。

  6. 在注释正文字段中键入问题的说明。

  7. 如果你是项目维护者,可以将问题分配给某人将其添加到 项目将其与里程碑关联设置问题类型、或