首页/开发/Git 与协作速查/草稿 PR / Draft MR
协作与代码评审75 条

草稿 PR / Draft MR

未完成的变更先开草稿:GitHub 用 Convert to draft 或 --draft,GitLab 用 Draft: 前缀;草稿状态通常不触发必需评审与合并队列。

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

草稿评审请求是什么

未完成的变更先以草稿形式提出评审请求:平台支持把评审标记为草稿状态,草稿一般不会触发必需评审与合并队列,但流水线仍可运行、评论仍可进行。它适合在早期征求方向性意见,避免评审者把精力花在会返工的细节上。

基本信息

GitHub创建时加草稿参数,或在页面上把评审转为草稿
GitLab在标题前加草稿前缀
状态效果可运行流水线、可评论,通常不可合并
转正方式准备就绪后把评审标记为可评审
提示两个平台的入口与命名不同,规则细节以各自文档为准

典型使用场景

  • 早期征求方向性意见,先看设计再抠细节
  • 长周期改动需要提前让团队知晓进度
  • 依赖的其他分支或接口尚未就绪
  • 希望先跑一轮流水线验证构建环境
  • 评审未完成但想先记录讨论与决策过程

常用示例

常用示例
gh pr create --draft --fill        # 创建草稿评审
gh pr ready 128                    # 转为可评审
glab mr update 128 --ready         # 另一个平台的对应操作
gh pr view 128 --json isDraft      # 确认当前是否为草稿状态
gh pr checks 128                   # 草稿状态同样可以查看流水线结果

草稿与正式对照

项目草稿状态正式状态
能否合并通常不可合并满足规则后可合并
必需评审一般不触发按规则触发
流水线可以运行可以运行
评论讨论可以正常进行可以正常进行
草稿适合早期征求方向性意见;代码接近完成再转为正式,避免评审者把时间消耗在大量返工上。
草稿状态常被合并规则跳过,不要把未通过校验的分支直接标记为可评审,容易造成误合入。
草稿阶段就写清改动的目标、范围与验证方式,转正时评审者能立刻进入重点,不必来回追问背景。

易错点

  • 把未通过校验的分支标记为可评审,规则一旦放行就会误合入主干
  • 长期停留在草稿状态无人推进,评审者逐渐失去关注,最后赶在截止前仓促合入
  • 使用旧式的进行中前缀而平台不再识别,草稿语义失效,仍会被当作待评审处理
  • 把草稿当成「不用维护」的占位,分支长期不更新主干,转正时冲突集中爆发

数据来源与参考

  • GitHub Docs:Draft pull requests
  • GitLab Docs:Draft merge requests
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌