Git 分支管理规范有哪些最佳实践？

Git 分支管理没有唯一的标准答案，但大多数协作团队适合采用基于 Git Flow 演进的规范：主分支始终保护，功能分支从开发分支切出，发布分支短期保留并及时清理。

先说结论：分支策略需适配团队节奏，盲目套用模型或单主干都可能在数月后引发冲突爆炸。

适合：有明确发布周期、多人协作的企业级项目
先看：主分支保护规则与自动化 CI 校验是否到位
建议：功能分支命名带作用域，合并后及时删除本地分支

命令速用版

# 创建功能分支（从 develop 切出）
git checkout -b feature/user-login develop
# 同步远程最新代码（避免起点落后）
git pull `--rebase` origin develop
# 合并到开发分支（保留历史）
git checkout develop
git merge `--no-ff` feature/user-login
# 推送远程并删除本地已合并分支
git push origin develop
git branch -d feature/user-login
# 查看分支列表
git branch -a

主流平台保护规则配置

分支规范不能仅靠自觉，必须在代码托管平台设置强制保护规则。

GitHub 配置步骤：

进入仓库 Settings > Branches。
点击 Add branch protection rule。
Branch name pattern 填写 main 或 develop。
勾选 Require a pull request before merging 和 Require status checks to pass before merging。
保存规则，禁止直接 Push。

GitLab 配置步骤：

进入项目 Settings > Repository。
展开 Protected branches 区域。
Branch 选择 main 或 develop，Allowed to merge 选择 Maintainers，Allowed to push 选择 No one。
点击 Protect 保存。

自动化校验与集成

通过 CI/CD 流水线和本地 Hook 强制约束分支命名和提交规范，减少人工审查成本。

1. CI 流水线分支校验（GitHub Actions 示例）：

name: Branch Name Check
on: [pull_request]
jobs:
  check-branch:
    runs-on: ubuntu-latest
    steps:
      - name: Check branch name
        run: |
          if [[ ! "$GITHUB_HEAD_REF" =~ ^(feature|hotfix|release)/ ]]; then
            echo "Branch name must start with feature/, hotfix/, or release/"
            exit 1
          fi

2. 本地 Git Hook 强制命名（.git/hooks/commit-msg）：

#!/bin/sh
commit_msg=$(cat "$1")
if ! echo "$commit_msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)"; then
  echo "ERROR: Commit message must start with feat|fix|docs|style|refactor|test|chore"
  exit 1
fi

分步处理

1. 确定分支模型
核心分支通常包括 main/master（生产）、develop（开发）、feature/*（功能）、release/*（发布）、hotfix/*（修复）。紧急修复必须从主分支切出，修复后同时合入主分支和开发分支。

2. 设置保护规则
主分支和开发分支应设置为保护分支，禁止直接推送，必须通过 Pull Request 并完成代码审查。功能分支开发周期建议控制在 1 周内，避免长期不合并。

3. 统一命名规范
采用 type/description 格式，如 feature/module-function。名字不带作用域和意图会增加协作成本，导致 PR 标题和日志难以识别。

4. 明确合并策略
团队统一选择 merge 或 rebase。混合使用会让历史记录混乱，影响问题追溯。合并成功后，立即删除本地分支，避免干扰分支列表。

怎么验证是否生效

执行 git branch -a 检查分支列表是否整洁，无长期滞留的功能分支。查看 CI 日志，确认合并请求是否触发了自动化测试且分支命名校验通过。检查主分支历史，确认是否有未经 PR 的直接提交。

常见坑

1. 热修复未同步：hotfix 合并到主分支后，必须立即合并回开发分支，防止后续开发覆盖修复。
2. 远程分支强制推送：已推送到远程的分支禁止 rebase 后强制推送，这会破坏协作历史。
3. 发布分支长期保留：release 分支仅短期保留，版本验证完成后应删除，长期挂着是仓库熵增的信号。
4. 切分支前未同步：切之前务必先 pull 最新代码，否则新分支起点落后，后续合并时大概率触发假冲突。

笙亿网络策划