跳到主要内容

合并请求

功能概述

为保障主分支(main)的接口稳定性与质量,当主分支设置为受保护状态时:

  • 拥有主分支读写/只读权限的成员无法直接合并
  • 必须通过创建合并请求(Merge Request),由项目管理员群组管理员审核通过后方可合并。

📌 核心价值:确保主分支接口经过严格评审,降低生产环境风险。

操作流程详解

1. 发起合并请求

适用角色:开发者(主分支读写/只读权限成员)
步骤

  1. 在开发分支完成接口等修改后,点击操作栏 合并到主分支 按钮。

  2. 选择需合并的资源

    • ✅ 系统自动筛选出新增或修改过的资源(推荐直接提交)。
    • ⚠️ 避免勾选未变更文件,减少冲突概率。
  3. 点击 创建合并请求

    • 填写描述(必填):清晰说明本次合并的目的、影响范围及测试验证情况。
    • 系统自动生成数据快照:系统基于当前分支的数据生成不可变的快照,后续分支改动不影响此合并请求。

image.png

image.png


2. 审核与处理合并请求

适用角色:项目管理员 / 群组管理员
步骤

  1. 进入主分支面板,查看待处理的合并请求列表。
  2. 点击请求进入审核模式
    • 差异对比:系统自动展示提交快照主分支最新实时数据的差异(Diff视图)。
    • 冲突解决使用手册
  3. 做出审核决策:
    • ✅ 通过:接口等合并至主分支,流程结束。
    • ❌ 驳回:填写详细驳回原因(如逻辑缺陷、测试不足),提交者需修改后重新发起请求。

image.png

image.png

image.png

3. 查看历史合并请求

适用角色:所有成员

  • 点击 已合并 已驳回 ,可查看已处理请求的:

    • 审核结果(通过/驳回)
    • 提交时的数据快照(含接口详情、冲突点)
    • 驳回原因(若存在)

🔍 用途:快速回溯合并记录,定位版本问题。

关键机制说明

1. 数据快照机制

  • 合并请求创建时,系统基于提交的数据生成只读快照
  • 后续在分支中修改不影响已提交的请求内容,确保评审一致性。

2. 冲突解决规则

  • 冲突仅由审核员在合并阶段处理,提交者无需操作。使用手册
  • 对比依据:提交快照 vs 主分支最新实时数据

3. 权限控制

操作开发者管理员
创建合并请求可直接合并
审核/解决冲突

常见问题解答

Q1:为什么我无法直接合并到主分支?

答:主分支处于受保护状态。请按流程创建合并请求,由管理员审核合并。

Q2:审核期间我能否修改已提交的请求?

答:否。请求基于创建时的快照,如需修改请重新提交新的合并请求。

Q3:冲突如何通知提交者?

答:冲突由管理员解决,若需调整会直接驳回并注明原因。

提示:合理利用合并请求描述字段,显著提升审核效率!