Git 发布规范（企业级工程实践）#

一、为什么需要发布规范#

没有发布规范的项目通常会出现：

• 版本号混乱（v1、v1.1_final、v1_fix）
• 不知道哪些提交已经上线
• 线上 Bug 无法快速回滚
• API 被破坏却无感知

发布规范的目标是：

• 每一次上线都是可追溯的
• 每一个版本都有明确语义
• 自动生成 changelog
• 自动触发 CI/CD

二、核心组成#

本规范由三部分组成：

三者结合后，就形成了一套可自动化的发布体系。

三、分支模型（Git Flow）#

标准分支如下：

1
main        # 生产环境代码
2
develop     # 开发主分支
3
feature/*   # 功能开发
4
release/*   # 发版准备
5
hotfix/*    # 线上紧急修复

四、版本号规则（SemVer）#

格式：

1
MAJOR.MINOR.PATCH

示例：

1
v1.0.0
2
v1.2.3
3
v2.0.0

含义：

五、Commit Message 规范#

格式：

1
<type>(<scope>): <subject>

示例：

1
feat(auth): add jwt refresh token
2
fix(cache): prevent redis deadlock
3
refactor(repo): simplify repository layer

1
feat(auth)!: change jwt payload structure

1
BREAKING CHANGE: token format updated

六、标准发布流程#

1
git checkout develop
2
git checkout -b feature/login
3
git commit -m "feat(auth): implement login"
4
git push

1
git checkout develop
2
git checkout -b release/1.2.0

1
git commit -m "fix(auth): correct token expiry"

1
git checkout main
2
git merge release/1.2.0
3
git tag v1.2.0
4
git push origin main --tags

1
git checkout develop
2
git merge release/1.2.0

七、线上紧急修复（Hotfix）#

1
git checkout main
2
git checkout -b hotfix/1.2.1
3
git commit -m "fix(cache): avoid nil pointer"
4
git checkout main
5
git merge hotfix/1.2.1
6
git tag v1.2.1
7
git push --tags
8
git checkout develop
9
git merge hotfix/1.2.1

八、自动化发布#

使用此规范，可以直接接入：

• semantic-release
• GitHub Actions
• GitLab CI

自动完成：

• 计算版本号
• 生成 CHANGELOG
• 打 tag
• 发布 GitHub Release
• 发布 Go Module / npm 包

九、结论#

Git 发布规范是区分“写代码”和“做工程”的分水岭。

如果你在做的是：

• API Server
• 基础库
• 框架
• 团队项目

你必须使用这一套规范。