团队 Git 开发协作规范指引

一、文档目的

统一团队 Git 分支管理、代码提交、合并及发布流程，规范多人协作模式，保证代码可追溯、分支清晰、生产环境稳定，降低协作冲突与线上风险。

分支名称	类型	作用	权限控制
`master`	生产稳定分支	存放已上线、可直接部署的生产代码，永远保持稳定	1. 禁止直接提交/推送 2. 仅管理员可合并发布分支 3. 必须打 Tag 固化版本
`dev`	开发主分支	日常开发核心分支，所有功能、bug 修复最终汇聚于此	1. 禁止直接提交代码 2. 仅通过 PR 合并个人分支 3. 开发人员可拉取、发起合并
`release/版本号`	发布分支	预发布、测试专用分支（如 `release/8.4.0.900`）	1. 仅从 `dev` 合并代码 2. 禁止直接开发 3. 上线后合并 master 并删除
`feature/功能名`	功能分支	开发新功能使用（个人临时分支）	开发人员自行创建、开发，完成后删除
`bugfix/问题编号`	缺陷修复分支	修复测试/开发环境 bug 使用（个人临时分支）	开发人员自行创建、开发，完成后删除
`hotfix/问题描述`	生产紧急修复分支	仅用于线上生产环境紧急 bug修复	仅核心开发创建，必须同步合并到 dev 和 master

每次开发前，必须同步最新 dev 分支代码，避免冲突：

bash 复制代码

# 切换到 dev 分支
git checkout dev
# 拉取最新代码
git pull origin dev

禁止直接在 dev 分支开发，必须从最新 dev 拉取个人分支：

bash 复制代码

# 功能开发
git checkout -b feature/xxx
# bug 修复
git checkout -b bugfix/xxx

开发完成后，推送个人分支到远程，发起 PR（合并请求） 合并到 dev 分支：

从 dev 分支创建发布分支，用于测试、预发布：

bash 复制代码

git checkout dev
git pull
git checkout -b release/8.4.0.900
git push origin release/8.4.0.900

使用 release/版本号 分支代码部署生产环境，验证上线成功。

在 master 分支打 Tag 永久固化版本（回滚唯一依据）

bash 复制代码

git checkout master
git pull
git merge --no-ff release/8.4.0.900
git tag -a v8.4.0.900 -m "生产上线版本 v8.4.0.900"
git push origin master --tags

仅用于线上已发布版本出现紧急 bug，禁止常规开发使用：

本规范为团队标准 Git 协作流程，所有开发人员必须严格遵守，如有特殊场景需调整，需统一沟通确认后更新文档。