小团队够用的 Git 工作流

Git Flow 功能完备，但对于三五个人的团队往往显得笨重。下面是一套基于主干开发的简化约定，足够应对大多数项目。

一、分支模型

• main：始终可发布，受保护，只能通过 Pull Request 合入。
• feat/xxx、fix/xxx：从 main 拉出的短期分支，生命周期尽量不超过几天。
• 发布通过在 main 上打 tag 完成，例如 v1.4.0。

分支活得越久，合并冲突越痛苦。小步提交、尽快合入，是这套工作流的核心。

二、提交信息规范

推荐采用 Conventional Commits 格式，便于阅读历史和自动生成 changelog：

feat(login): 支持短信验证码登录
fix(cart): 修复数量为 0 时仍可下单的问题
docs: 更新部署说明
refactor(api): 抽取统一的请求错误处理

三、rebase 还是 merge？

一个简单的原则：

• 同步主干到自己的分支：用 rebase，保持提交历史线性。
• 合入主干：用 PR 的 “Squash and merge”，一个功能对应 main 上的一个提交。
• 永远不要 rebase 已经被别人拉取的公共分支。

git checkout feat/login
git fetch origin
git rebase origin/main
# 解决冲突后
git push --force-with-lease

--force-with-lease 比 --force 更安全：如果远端有你没拉取到的新提交，推送会被拒绝。

四、几个实用命令

git switch -c feat/new-page        # 新建并切换分支
git commit --fixup <sha>           # 修补某个旧提交
git rebase -i --autosquash main    # 自动合并 fixup 提交
git stash push -m "临时保存"        # 暂存当前修改
git log --oneline --graph -20      # 查看简洁的分支图

小结

短分支、规范提交、PR 合入、tag 发布——规则越少越容易坚持，坚持下来就是好的工作流。