问题交叉链接
- 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 就会被链接。有关更多信息,请参阅使用问题编号作为分支名称前缀。