Git 工作流最佳实践

为什么需要规范的工作流？

混乱的 Git 使用会导致：

• 代码冲突频繁
• 历史记录难以追溯
• 回滚困难
• 团队协作效率低下

分支命名规范

feature/user-auth      # 新功能
bugfix/login-error     # 修复 bug
hotfix/critical-issue  # 紧急修复
release/v1.2.0         # 发布分支
docs/api-reference     # 文档更新
refactor/auth-module   # 重构

Git Flow 工作流

核心分支

• main：生产环境代码，随时可部署
• develop：开发主干，集成功能分支
• feature/*：功能开发分支
• release/*：发布准备分支
• hotfix/*：紧急修复分支

工作流程

1. 从 develop 创建 feature 分支
2. 完成开发后提交 PR/MR
3. Code Review 通过后合并到 develop
4. 准备发布时创建 release 分支
5. 测试通过后合并到 main 和 develop

GitHub Flow（简化版）

适合小团队和持续部署：

1. 从 main 创建功能分支
2. 开发并提交 PR
3. Review 通过后直接合并到 main
4. 自动部署到生产

提交信息规范

# 格式：<type>(<scope>): <subject>

# type 类型
feat:     新功能
fix:      修复 bug
docs:     文档更新
style:    代码格式（不影响功能）
refactor: 重构
test:     测试相关
chore:    构建工具、依赖等

# 示例
feat(auth): 添加 JWT 令牌刷新功能
fix(api): 修复用户查询接口空指针异常
docs(readme): 更新安装说明

实用技巧

1. 提交前检查

git status
git diff --cached
git log --oneline -5

2. 优雅地解决冲突

git pull --rebase origin develop
# 解决冲突后
git rebase --continue

3. 撤销操作

git reset --soft HEAD~1    # 撤销提交，保留更改
git reset --hard HEAD~1    # 彻底撤销（慎用）
git revert <commit-hash>   # 安全撤销已推送的提交

4. 整理提交历史

git rebase -i HEAD~5       # 交互式变基，合并/编辑提交

团队协作建议

1. 小步提交：每个提交只做一件事
2. 及时同步：每天至少 pull 一次主分支
3. Code Review：所有合并必须经过审查
4. CI/CD：自动化测试和部署
5. 保护分支：main/develop 禁止直接推送

结语

好的 Git 工作流是团队协作的基石。选择适合团队规模的方式，坚持执行，会让开发效率大幅提升。