Git 文档

功能分支

• main：生产分支
• dev：开发分支

分支命名规则

分支类型	前缀	示例	用途
功能开发	feature/	feature/user-login	新功能开发
代码优化	refactor/	refactor/auth-logic	代码重构优化
Bug修复	fix/	fix/login-bug	修复缺陷
性能优化	optimize/	optimize/db-query	性能提升
文档更新	docs/	docs/api-update	文档维护
样式改进	style/	style/ui-improve	CSS/样式优化

提交类型说明

类型	说明
feat	新增功能
fix	修复 bug
docs	仅文档更改
style	不影响代码含义的更改（空白、格式设置、缺少分号等）
refactor	既不修复 bug 也不添加特性的代码更改
perf	改进性能的代码更改
test	添加缺少的测试或更正现有测试
chore	对构建过程或辅助工具和库（如文档）的更改

合并分支及上线流程

1. 新需求从 main 切出需求分支
2. 需求开发完成，需求分支合并到 dev
3. 测试通过，需求分支合并到 main

环境部署说明

• 开发环境部署：功能分支合并到 dev 后，会触发云效流水线自动部署到开发环境
• 生产环境部署：功能分支合并到 main 后，打 tag 然后 push，触发云效流水线自动部署到生产环境

Git Tag 规范

打 Tag 及 Push 样例

1. 使用注解 Tag

   git tag -a v1.2.3 -m "详细的发布说明"
   

2. 立即推送 Tag

   git push origin v1.2.3
   

3. 验证 Tag

   git show v1.2.3
   

Git Tag 版本号递增规则

变更类型	版本递增	示例
Bug 修复	修订号 +1	v1.2.3 → v1.2.4
新功能（兼容）	次版本号 +1	v1.2.3 → v1.3.0
重大变更（不兼容）	主版本号 +1	v1.2.3 → v2.0.0
预发布	添加后缀	v1.2.3 → v1.2.4-rc.1

Git 标签提交规范

标签类型与格式

类型	示例	说明
Release	v1.5.0	正式版本发布，包含新功能和优化
Hotfix	v1.5.1	紧急修复线上问题

Git Tag 上线流程样例

版本上线

git checkout main
git pull
git tag -a v1.5.0 -m "Release
- 新增支付功能
- 优化订单流程  
- 修复安全漏洞"
git push origin v1.5.0

紧急修复

git checkout main
git pull
git tag -a v1.5.1 -m "Hotfix
- 修复支付金额计算错误的 Bug
- 修复订单状态未正确更新的问题"
git push origin v1.5.1

格式解析

Release/Hotfix    ← 第一行：固定格式
- [修改点1]       ← 后续行：变更列表
- [修改点2]
- [修改点3]