首页/开发/Git 与协作速查/glab mr create 创建合并请求
协作与代码评审75 条

glab mr create 创建合并请求

GitLab CLI 创建 MR:可指定源/目标分支、标题描述、草稿状态、评审人;也支持用 --fill 从提交与分支名生成描述。

Git 与协作速查开发更新于 2026-10-13

glab mr create 是什么

glab 是 GitLab 的命令行工具,glab mr create 用于在命令行创建合并请求,可指定源分支与目标分支、标题与描述、草稿状态与评审人。--fill 能用提交信息与分支名生成描述初稿,适合把创建动作写进脚本。GitLab 用 Draft: 前缀标记草稿,--draft 会自动加上该前缀,后续在界面上移除即转为可评审状态。自建 GitLab 需先配置主机与令牌。

基本信息

用途命令行创建 MR
常用参数--source-branch/--target-branch、--title/--description、--draft、--reviewer
快捷参数--fill 从提交与分支名生成描述
前置分支已推送、项目已启用 MR
平台GitLab(含自建实例)

典型使用场景

  • 推送分支后立即创建 MR,不用切到网页
  • 跨版本维护时指定目标分支,避免合错位置
  • 先建草稿收集早期反馈,成熟后转正式评审
  • 脚本或 CI 中批量建单,统一描述模板
  • 用 --fill 快速起稿,再补验证说明
  • 自建 GitLab 上完成认证后统一走命令行流程

常用示例

常用示例
glab auth login                                   # 首次配置主机与令牌
glab mr create --source-branch feature/login --target-branch main --draft
glab mr create --fill                             # 用提交与分支名生成描述
glab mr view --web                                # 打开刚创建的 MR
glab mr list                                      # 查看与当前分支相关的 MR

常用参数

参数作用
--source-branch指定源分支,默认取当前分支
--target-branch指定目标分支
--draft创建为草稿,标题加 Draft: 前缀
--fill用提交信息与分支名填充描述
GitLab 用 Draft: 前缀标记草稿;glab --draft 会加上该前缀,后续在界面上移除即转为可评审状态。
源分支留空时默认取当前分支;多项目或同名分支并存时用 --repo 明确指定仓库,避免把 MR 开到别的项目。

创建后的跟进动作

  • glab mr view --web 在浏览器核对目标分支与描述渲染
  • 确认流水线状态,红了先修再请人评审
  • 草稿成熟后移除标题前缀转为可评审
  • 合并后及时删除远端分支,保持列表干净
描述同样建议按「背景、改动、验证、风险、关联项」组织,与 GitHub 侧的模板习惯保持一致,团队换平台时不用重新适应。

易错点

  • 自建 GitLab 需先配置主机与令牌,否则命令直接失败
  • 源分支留空时默认取当前分支,远端同名分支可能有多个项目,注意用 --repo 指定
  • 目标分支写错会把 MR 合向非预期分支,跨版本仓库必须显式指定
  • 描述只靠 --fill 生成容易缺少验证步骤与影响面,仍需人工补齐
  • 认证令牌过期后命令会失败,排查前先确认认证状态

数据来源与参考

  • GitLab CLI 文档:glab mr create(docs.gitlab.com)
  • GitLab Docs:Merge requests
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌