glab-mr

glab mr

创建、查看和管理 GitLab merge request（合并请求）。

快速入门

# 从当前分支创建 MR
glab mr create --fill

# 列出我的 MR
glab mr list --assignee=@me

# 审查一个 MR
glab mr checkout 123
glab mr diff
glab mr approve

# 合并一个 MR
glab mr merge 123 --when-pipeline-succeeds --remove-source-branch

常用工作流

创建 MR

从当前分支创建：

glab mr create --fill --label bugfix --assignee @reviewer

从议题创建：

glab mr for 456  # 创建与议题 #456 关联的 MR

创建草稿 MR：

glab mr create --draft --title "WIP: Feature X"

审查工作流

1. 列出待审查的 MR：

   glab mr list --reviewer=@me --state=opened
   

2. 检出并测试：

   glab mr checkout 123
   npm test
   

3. 提交反馈：

   glab mr note 123 -m "Looks good, one question about the cache logic"
   
   # 在添加备注的同时解决讨论线程（v1.88.0+）
   glab mr note 123 --resolve <discussion-id> -m "Fixed, addressed in latest commit."
   
   # 重新打开已解决的线程
   glab mr note 123 --unresolve <discussion-id>
   

4. 批准：

   glab mr approve 123
   

自动化审查工作流：

对于重复性的审查任务，可以使用自动化脚本：

scripts/mr-review-workflow.sh 123
scripts/mr-review-workflow.sh 123 "pnpm test"

该脚本自动完成：检出 → 运行测试 → 发布结果 → 测试通过则批准。

合并策略

流水线通过后自动合并：

glab mr merge 123 --when-pipeline-succeeds --remove-source-branch

压缩提交：

glab mr merge 123 --squash

合并前变基：

glab mr rebase 123
glab mr merge 123

故障排除

合并冲突：

• 检出 MR：glab mr checkout 123
• 在编辑器中手动解决冲突
• 提交解决结果：git add . && git commit
• 推送：git push

无法批准 MR：

• 检查你是否是作者（大多数配置下不能自我批准）
• 验证权限：glab mr approvers 123
• 确保 MR 不处于草稿状态

流水线未运行但又是必需的：

• 检查分支中是否存在 .gitlab-ci.yml
• 验证项目是否启用了 CI/CD
• 手动触发：glab ci run

"MR already exists" 错误：

• 列出该分支的现有 MR：glab mr list --source-branch <branch>
• 如果已过时则关闭旧 MR：glab mr close <id>
• 或更新现有的：glab mr update <id> --title "New title"

相关技能

处理议题：

• 参见 glab-issue 了解议题的创建和管理
• 使用 glab mr for <issue-id> 创建与议题关联的 MR
• 脚本：scripts/create-mr-from-issue.sh 自动化分支创建 + MR 创建