合并请求
功能概述
为保障主分支(main
)的接口稳定性与质量,当主分支设置为受保护状态时:
- 拥有主分支读写/只读权限的成员无法直接合并。
- 必须通过创建合并请求(Merge Request),由项目管理员或群组管理员审核通过后方可合并。
📌 核心价值:确保主分支接口经过严格评审,降低生产环境风险。
操作流程详解
1. 发起合并请求
适用角色:开发者(主分支读写/只读权限成员)
步骤:
在开发分支完成接口等修改后,点击操作栏
合并到主分支
按钮。选择需合并的资源:
- ✅ 系统自动筛选出新增或修改过的资源(推荐直接提交)。
- ⚠️ 避免勾选未变更文件,减少冲突概率。
点击
创建合并请求
:- 填写描述(必填):清晰说明本次合并的目的、影响范围及测试验证情况。
- 系统自动生成数据快照:系统基于当前分支的数据生成不可变的快照,后续分支改动不影响此合并请求。
2. 审核与处理合并请求
适用角色:项目管理员 / 群组管理员
步骤:
- 进入主分支面板,查看待处理的合并请求列表。
- 点击请求进入审核模式:
- 差异对比:系统自动展示提交快照与主分支最新实时数据的差异(Diff视图)。
- 冲突解决:使用手册
- 做出审核决策:
- ✅ 通过:接口等合并至主分支,流程结束。
- ❌ 驳回:填写详细驳回原因(如逻辑缺陷、测试不足),提交者需修改后重新发起请求。
3. 查看历史合并请求
适用角色:所有成员
点击
已合并
已驳回
,可查看已处理请求的:- 审核结果(通过/驳回)
- 提交时的数据快照(含接口详情、冲突点)
- 驳回原因(若存在)
🔍 用途:快速回溯合并记录,定位版本问题。
关键机制说明
1. 数据快照机制
- 合并请求创建时,系统基于提交的数据生成只读快照。
- 后续在分支中修改不影响已提交的请求内容,确保评审一致性。
2. 冲突解决规则
- 冲突仅由审核员在合并阶段处理,提交者无需操作。使用手册
- 对比依据:提交快照 vs 主分支最新实时数据。
3. 权限控制
操作 | 开发者 | 管理员 |
---|---|---|
创建合并请求 | ✅ | 可直接合并 |
审核/解决冲突 | ❌ | ✅ |
常见问题解答
Q1:为什么我无法直接合并到主分支?
答:主分支处于受保护状态。请按流程创建合并请求,由管理员审核合并。
Q2:审核期间我能否修改已提交的请求?
答:否。请求基于创建时的快照,如需修改请重新提交新的合并请求。
Q3:冲突如何通知提交者?
答:冲突由管理员解决,若需调整会直接驳回并注明原因。
提示:合理利用合并请求描述字段,显著提升审核效率!