Help us learn about your current experience with the documentation. Take the survey.

问题交叉链接

  • Tier: 免费版、高级版、旗舰版
  • Offering: GitLab.com、GitLab 自托管、GitLab 专用版

交叉链接在 GitLab 中创建问题之间的关系。 交叉链接:

  • 连接相关问题,便于跟踪和查看。
  • 将问题链接到相关的提交和合并请求。
  • 通过提交信息、分支名称和描述创建引用。
  • 跨项目和群组工作。
  • 在每个问题的"关联项目"部分显示关系。

你可以通过以下方式创建交叉链接:

从提交信息

每次在提交信息中提及问题时,你都在创建开发工作流两个阶段之间的关系:问题本身和与该问题相关的第一个提交。

如果问题和你要提交的代码都在同一个项目中,在提交信息中添加 #xxx,其中 xxx 是问题编号。

git commit -m "this is my commit message. Ref #xxx"

提交信息通常不能以 # 字符开头,因此你也可以使用替代的 GL-xxx 格式:

git commit -m "GL-xxx: this is my commit message"

如果它们在不同的项目中,但在同一个群组中,在提交信息中添加 projectname#xxx

git commit -m "this is my commit message. Ref projectname#xxx"

如果它们不在同一个群组中,你可以添加问题的完整 URL(https://gitlab.com/<username>/<projectname>/-/issues/<xxx>)。

出于性能原因,GitLab 只处理提交信息中的前 1,000 个完整 URL 进行自动链接。超出此限制的额外 URL 不会转换为链接。

git commit -m "this is my commit message. Related to https://gitlab.com/<username>/<projectname>/-/issues/<xxx>"

当然,你可以将 gitlab.com 替换为你自己 GitLab 实例的 URL。

将你的第一个提交链接到你的问题对于使用 GitLab 价值流分析 跟踪你的流程很重要。它衡量了规划该问题实施所需的时间,即从创建问题到进行第一次提交之间的时间。

从关联的问题

在合并请求和其他问题中提及关联问题,有助于你的团队成员和协作者了解有关于同一主题的未解决问题。

在问题 #222 中提及问题 #111 时,问题 #111 也会在其"活动"信息流中显示通知。也就是说,你只需要提及一次关系,它就会显示在两个问题中。在 合并请求 中提及问题时也是如此。

当问题的活动信息流筛选为"仅显示历史"或"显示所有活动"时,交叉链接显示为"(用户名)在问题 #(编号)(时间前)中提及"。

从合并请求

在合并请求评论中提及问题的方式与 关联问题 完全相同。

当你在合并请求描述中提及问题时,它会将问题和合并请求链接在一起。此外,你还可以设置问题自动关闭,一旦合并请求被合并。

当问题的活动信息流筛选为"仅显示历史"或"显示所有活动"时,交叉链接显示为"(用户名)在合并请求 !(编号)(时间前)中提及"。

从分支名称

当你在与问题相同的项目中创建分支,并以问题编号开头,后跟连字符时,你创建的问题和 MR 就会被链接。有关更多信息,请参阅使用问题编号作为分支名称前缀