跳到主要内容

分支功能介绍

1. 引言

本章节聚焦于分支功能的详细介绍,旨在为用户提供全面且实用的指导。通过本章节内容,用户能够清晰了解分支功能的核心逻辑与操作方法,学会如何借助分支功能高效开展迭代开发工作,实现对项目版本的科学管理,并顺畅进行团队协作,提升整体开发效率与项目质量。

2. 分支功能概述

2.1 什么是分支?

分支是为满足特定功能开发需求或版本迭代工作而创建的临时分支从本质上来说,它是一个完全独立于主分支的项目,形成了一条独立的开发线。在分支中,开发者可以对接口进行独立修改,整个开发过程不会对主分支的稳定性造成任何影响。当开发工作完成后,需通过提交合并操作,将分支内的成果整合至主分支

2.2 分支的核心适用场景与价值

🔒 安全协作开发
严格限制开发人员直接修改主分支权限,所有变更需通过分支提交审核后合并,避免人为失误破坏生产环境。

🛠️ 新功能独立开发
为每个新功能/版本创建独立分支,开发、测试、联调全程隔离,不影响主分支稳定性。

🔄 接口无风险升级
在分支内修改API副本(如参数调整、逻辑优化),验证后覆盖合并至主分支,确保线上服务零干扰

🧪 实验性功能验证
高风险功能(如架构改造)在分支内试错,失败可丢弃分支,成功则合并,降低创新成本。

紧急缺陷修复
生产环境突发Bug时,快速创建修复分支,完成补丁并验证后合并,与常规开发流解耦。

信息

原则提示:分支需遵循“短期用完即归档”,避免长期堆积;合并前务必进行差异对比,确保变更精准可控。

3. 分支功能核心流程

  1. 创建与管理分支 使用文档
    创建新分支,支持独立命名与管理(如设置权限、管理分支人员等)。
  1. 拉取主分支数据 使用文档
    将主分支中 本次迭代所需的接口数据 同步至当前分支。
  1. 分支内独立开发
    在完全隔离的环境中进行接口开发/修改,不影响主分支及其他分支。

  2. 发起合并 使用文档

  • 开发完成后,向主分支提交分支内的 接口变更内容。
  • 主分支在不受保护状态下可直接合并,在主分支为只读权限的成员依旧需要审核无法直接合并
  1. 审核合并请求(仅主分支受保护时触发) 使用文档
    主分支受保护时,需管理员审核合并请求;普通成员无直接合并权限。
  1. 解决冲突并合并 使用文档
    自动/手动处理主分支与分支的数据冲突,确认后完成合并。
  1. 独立管理分支成员 使用文档
    动态配置分支成员权限(如只读、读写、分支管理员等),与主分支权限体系解耦。

image.png