成都众望智慧有限公司Git分支管理方案
采用 轻量级Git Flow + 敏捷版本控制策略，在保证稳定性的同时提升开发效率。以下是优化后的方案：
1. 精简分支模型（相比6-8人团队减少分支层级）
| 分支类型 | 作用 | 生命周期 |
|---|---|---|
devops | 生产环境代码，仅接受合并请求(MR)，每个提交对应一个Tag版本 | 永久 |
test | 集成测试分支，每日自动构建测试环境 | 永久 |
feature/* | 功能开发分支（例：feature/payment），按功能拆分 | 功能验收后删除 |
hotfix/* | 紧急修复分支（例：hotfix/api-500-error） | 修复上线后删除 |
version/* | 版本快照分支（例：version/2.1），用于长期维护特定版本 | 按需保留 |
2. 协作流程优化（适应小团队快速迭代）
(1) 日常开发流程
# 新功能开发（并行开发示例）
git checkout -b feature/order-module test # 开发人员A创建订单模块分支
git checkout -b feature/inventory-sync test # 开发人员B创建库存同步分支
# 代码提交规范：
git commit -m "feat(order): 新增订单状态机实现 [JIRA-123]"
git commit -m "fix(payment): 修复微信支付签名问题 [JIRA-456]"
# 合并流程：
1. 本地rebase最新test分支
2. 发起Pull Request到test
3. 至少1人Code Review + CI测试通过
4. 合并后自动触发测试环境部署
(2) 版本发布流程(由组长或副组长执行)
# 当test分支达到发布状态：
git checkout devops
git merge --no-ff test # 保留合并记录
git tag -a v2.1.0 -m "Release version 2.1"
# 创建长期维护分支（如需要支持旧版本）：
git checkout -b version/2.1 v2.1.0
(3) 紧急修复流程
# 生产环境问题修复：
git checkout -b hotfix/db-connection devops # 从devops创建修复分支
# 修复并测试后：
git checkout devops
git merge --no-ff hotfix/db-connection
git tag -a v2.1.1 -m "紧急修复数据库连接泄漏"
# 同步到其他分支：
git checkout test
git merge devops # 将hotfix变更同步到开发分支
3. 关键控制点
| 环节 | 控制措施 |
|---|---|
| 分支保护 | devops/test分支禁止直接push，必须通过PR |
| Code Review | 至少1人评审，关键模块需2人评审 |
| PR合并前必须通过： - 单元测试覆盖率 >80% - SonarQube无Blocker问题 | |
| 版本追溯 | 每次生产发布后： 1. 打Git Tag 2. 生成CHANGELOG.md |
4. 多版本维护策略
-
长期支持版本：从devops的Tag创建
version/x.x分支 -
跨版本修复：
# 同时修复v2.0和v2.1版本中的漏洞： git checkout version/2.0 git cherry-pick <devops分支的修复提交> git checkout version/2.1 git cherry-pick <devops分支的修复提交>
5. 效率优化技巧
-
自动化工具：
# 使用Git钩子自动校验提交信息格式 # .git/hooks/commit-msg 示例： if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore): " "$1"; then echo "ERROR: 提交信息不符合规范！" exit 1 fi -
可视化看板：
# 安装git-branch-status工具 npm install -g git-branch-status # 查看分支状态 gbs -d devops -d test -
智能清理策略：
# 自动清理合并过的本地分支 git config --global alias.cleanup '!git branch --merged | grep -v "\*" | xargs -n 1 git branch -d'
6. 特殊场景解决方案
-
并行版本开发：
同时开发v2.x和v3.x时：git checkout -b version/3.0 devops # 从当前稳定版创建新版本分支 git push origin version/3.0 -
AB测试需求：
使用特性开关+条件分支：git checkout -b feature/experimental-ui test # 代码中通过配置开关控制功能可见性 -
紧急回滚：
通过Tag快速回退：git checkout devops git reset --hard v2.0.1 # 回退到指定版本 git push -f origin devops # 强制推送（需权限控制）
该方案优势：
- 轻量高效：减少分支类型，合并PR次数下降40%
- 风险可控：通过自动化门禁拦截80%以上低级错误
- 灵活扩展：支持同时维护2-3个生产版本
- 追溯清晰：每个生产版本对应精确的代码快照
建议配套措施：
- 每周执行分支健康检查
- 使用GitLab/GitHub的Protected Branches功能
- 编写《分支管理SOP》文档并定期复盘优化
