Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

创建议题

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

谁可以使用此功能

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

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

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

从仓库创建议题

  1. 在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。 2. 在存储库名称下,单击 “问题”。 议题选项卡 1. 单击“新建问题”。 “新建问题”按钮
  2. 如果你的存储库使用问题模板,请在要打开的问题类型旁边单击“开始”。 选择要创建的问题类型,或者,如果可用选项中未包含你想要打开的问题类型,请单击“打开空白问题”。 可打开空白问题的链接 1. 键入议题的标题和说明。 示例问题 1. 如果你是项目维护者,可以将问题分配给某人将其添加到项目板将其与里程碑关联应用标签。 1. 完成后,单击“提交新问题”。

使用 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. 单击评论中的 拉取请求审查评论中的 Kebab 按钮
  3. 单击“新问题中的引用”。 “新问题中的引用”菜单项
  4. 使用“Repository(仓库)”下拉菜单,并选择要在其中打开议题的仓库。 新问题的“存储库”下拉列表
  5. 键入议题的描述性标题和正文。 新问题的标题和正文
  6. 单击“创建问题”。 用于创建新问题的按钮 1. 如果你是项目维护者,可以将问题分配给某人将其添加到项目板将其与里程碑关联应用标签。 1. 完成后,单击“提交新问题”。

从代码创建议题

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

在从代码打开的议题中渲染的代码片段

  1. 在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。
  2. 找到要在议题中引用的代码:
    • 要打开文件中代码相关的议题,请找到该文件。
    • 要打开拉取请求中代码相关的问题,请导航到该拉取请求并单击 “文件已更改”。 然后浏览到含有要包含在评论中的代码的文件,并单击“查看”。
  3. 选择是选择一行还是一个范围:
    • 要选择单行代码,请单击行号以高亮显示该行。 选择了单行代码的文件
      • 要选择代码范围,请单击范围内第一行的行号以高亮显示代码行。 然后,将鼠标停在代码范围的最后一行,按 Shift,再单击行号以突出显示范围。 选择了一个代码范围的文件
  4. 在代码范围左侧,单击 。 在下拉菜单中,单击“新问题中的引用”。 包含从所选行打开新问题的选项的 Kebab 菜单 1. 键入议题的标题和说明。 示例问题 1. 如果你是项目维护者,可以将问题分配给某人将其添加到项目板将其与里程碑关联应用标签。 1. 完成后,单击“提交新问题”。

从讨论创建议题

对存储库具有分类权限的人员可以从讨论创建议题。

从讨论创建议题时,讨论帖子的内容将自动包含在议题正文中,并且将保留所有标签。 从讨论创建议题不会将讨论转换为议题或删除现有讨论。 有关 GitHub Discussions 的详细信息,请参阅“关于讨论”。

  1. 在存储库或组织名称下,单击 “讨论”。

    GitHub 存储库中的选项卡的屏幕截图。 “讨论”选项以深橙色标出。 1. 在讨论列表中,单击要查看的讨论。

  2. 在右侧边栏中,单击 “根据讨论创建问题”。

    讨论中边栏的屏幕截图。 “根据讨论创建问题”选项以深橙色标出。

  3. 键入议题的标题和说明。 示例问题 1. 如果你是项目维护者,可以将问题分配给某人将其添加到项目板将其与里程碑关联应用标签。 1. 完成后,单击“提交新问题”。

从 项目版块 注释创建议题

如果使用 项目版块 对工作进行跟踪和排列优先级,则可以将注释转换为议题。 有关详细信息,请参阅“关于 project boards”和“向 project board 添加注释”。

从 URL 查询创建议题

您可以使用查询参数打开议题。 查询参数是 URL 中可以定制的部分,用于在 GitHub 上共享特定的网页视图,如搜索过滤结果或议题模板。 要创建自己的查询参数,必须将键与值进行配对。

提示:还可创建可通过默认标签、代理人和问题标题打开的问题模板。 有关详细信息,请参阅“使用模板鼓励有用的议题和拉取请求”。

必须具有适当的权限才可执行使用相关查询参数的操作。 例如,必须具有向问题添加标签的权限才可使用 labels 查询参数。 有关详细信息,请参阅“组织的存储库角色”。

如果使用查询参数创建了无效的 URL ,或者没有适当的权限,则 URL 将返回 404 Not Found 错误页面。 如果创建的 URL 超过服务器限制,URL 将返回 414 URI Too Long 错误页面。

查询参数示例
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report 创建标签为“bug”和标题为“新 bug 报告”的问题。
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. 在问题正文中创建标题为“新 bug 报告”的问题和评论“描述问题”。
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug 创建标签为“所需帮助”和“bug”的问题。
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones 创建里程碑为“测试里程碑”的问题。
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat 创建问题并将其分配给 @octocat。
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 创建标题为“Bug 修复”的问题,并将其添加到组织的项目板 1。
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md 在问题正文中使用模板创建问题。 template 查询参数适用于在存储库根目录 docs/.github/ISSUE_TEMPLATE 子目录中存储的模板。 有关详细信息,请参阅“使用模板鼓励有用的议题和拉取请求”。

延伸阅读