拉取 GitLab MR 的引用是什么

GitLab 把 MR 的头部提交暴露为 refs/merge-requests/<iid>/head，把试合并结果放在 refs/merge-requests/<iid>/merge：本地 fetch 这两个引用即可检出与平台一致的代码，排查「只在 MR 环境复现」的问题。

基本信息

典型使用场景

• 本地复现：检出 merge 引用运行测试，最接近平台试合并状态。
• 评审辅助：把 MR 分支拉到本地做代码走查或调试。
• CI 排查：对比 head 引用与本地分支找环境差异。
• 冲突预演：merge 引用缺失或冲突时说明平台侧试合并失败。
• 回退验证：怀疑 MR 引入回归时，检出 head 与其基底做排查。
• 发布预检：合并前在本地对 merge 引用跑全量测试，降低平台流水线反复。
• 自动化：脚本按 iid 批量取引用做静态检查。
• 对比平台：从 GitHub 迁移到 GitLab 时，把 pull/N/head 的用法换算为 merge-requests/N/head。

常用示例

git fetch origin merge-requests/45/head:mr-45   # 拉取 MR 头部到本地分支
git switch mr-45                                # 检出并查看
git log --oneline -3                            # 确认提交内容符合预期
# 试合并结果引用（平台无法试合并时可能缺失）
git fetch origin merge-requests/45/merge:mr-45-merge
git branch -D mr-45                             # 用完清理本地引用

引用对照