结论先行:中小团队的 Git 协作,推荐「主干开发 + 短生命周期特性分支 + Conventional Commits 规范 + PR 强制评审」的组合,而不是照搬重型 Git Flow。分支模型解决的是「代码何时集成」,commit 规范解决的是「历史能否被机器读取」,冲突处理解决的是「集成成本谁来付」。三件事的共同原则只有一个:让集成尽早发生、让历史保持线性可读、让冲突在小范围内解决。分支活得越久,冲突越贵,这是所有实践背后的经济学。
一、三种分支模型怎么选
| 模型 | 分支结构 | 发布节奏 | 适合团队 |
|---|---|---|---|
| Git Flow | main/develop/release/hotfix/feature | 版本制,周或月 | 客户端、需维护多版本的软件 |
| GitHub Flow | main + feature | 随时发布 | Web 服务、SaaS 产品 |
| Trunk Based | 主干 + 极短分支或直推 | 每日多次 | 工程成熟度高、CI 完善的团队 |
Git Flow 的问题在于 develop 与 main 长期并行,合并窗口集中,冲突与回归风险被人为攒大。Web 项目大多持续部署,GitHub Flow 足够;团队 CI 覆盖率高、特性开关用得好,可以进一步走向主干开发。选型判据很简单:你们的发布是「按版本」还是「按需求」?按版本选 Git Flow,按需求选后两者。
二、分支纪律:比模型更重要的四条规则
第一,特性分支生命周期不超过两三天,做不完就拆小需求,而不是养大分支。第二,每天至少把主干合并进自己的分支一次,把冲突摊到每天解决。第三,分支命名带类型与工单号,例如 feat/1234-coupon-page,让分支列表本身成为看板。第四,合并后立即删除远端分支,仓库里只保留活跃分支与受保护主干。这四条执行到位,用什么模型都不会太差;执行不到位,再漂亮的模型图也救不了。
三、Commit 规范:让历史可以被机器消费
推荐 Conventional Commits:格式为「类型(范围): 描述」,常用类型有 feat、fix、docs、refactor、perf、test、chore。例如 feat(cart): 支持优惠券叠加计算。规范的价值不在好看,而在自动化:commitlint 在提交时校验格式,semantic-release 或 standard-version 依据 feat 与 fix 自动升版本号、生成 changelog,BREAKING CHANGE 脚注触发主版本升级。
落地只需三步:安装 commitlint 与 husky,在 commit-msg 钩子里校验;给团队一页纸的类型说明与示例;CI 里对 PR 的提交记录再校验一次,防止绕过本地钩子。描述写「为什么改」而不是「改了什么」,diff 已经说明了后者。一次提交只做一件事,重构与功能修改分开提交,评审与回滚都会轻松很多。
四、PR 流程与评审底线
PR 要小:超过四百行 diff 的 PR 评审质量会断崖式下降,大需求用堆叠 PR 或分阶段合并。PR 描述写清背景、方案、影响面与自测情况,附截图或录屏。评审设两条底线:CI 全绿才可合并;至少一人批准且批准者不是作者本人。主干开启保护:禁止直推、禁止 force push、要求线性历史。合并策略推荐 squash merge,一个需求一个提交,主干历史干净,回滚粒度清晰。
五、冲突处理:流程比技巧重要
冲突的本质是两个人改了同一段代码,工具只能定位,决策必须靠人。标准流程:先合并主干进分支,git status 查看冲突文件,逐个打开理解双方意图,必要时直接找对方当面对齐,解决后 git add 并继续合并,最后跑一遍测试确认没有「解决冲突时引入的新 bug」。
git fetch origin
git merge origin/main
git status
git mergetool
git add .
git commit
npm test三个实用技巧:开启 git config rerere.enabled true,让 Git 记住你的冲突解法,重复冲突自动复用;用 git log --merge -p 查看造成冲突的双方提交,理解意图再动手;合并方向保持「主干进分支」而不是反过来,保证分支随时可弃。已经推送的公共分支不要 rebase,私有分支可以随意 rebase 整理,这条边界能避免绝大多数协作事故。
六、找一个真实仓库练手
规范看十遍不如在真实项目里走一遍完整流程。推荐用 api工厂的开源前端项目做练习场,比如 vueMinishop 或 wechat-app-mall(项目大全见 https://www.it120.cc/help/uq920k.html ):fork 之后建特性分支,给它加一个小功能,按 Conventional Commits 提交,再走一遍 PR 自查清单。这类项目业务完整、模块清晰,商品、订单、优惠券各自独立,很适合练习「小步提交、按模块拆分」的手感。如果团队用 Cursor、Trae 等 AI 编程工具,也可以接入 api工厂官方 MCP( https://www.it120.cc/ai.html ),让 AI 基于真实接口文档生成代码,再按本文规范提交,体验一遍「AI 产出 + 人类评审」的新协作流。
七、发布与回滚:闭环的最后一环
每次发布打 tag,格式 v主.次.补丁,与 changelog 对应。hotfix 从 tag 拉分支,修完同时合回主干,避免修复丢失。回滚优先用 git revert 生成反向提交,而不是 reset 抹历史——前者保留完整审计线索,后者会让所有协作者的本地仓库错乱。线上事故复盘时,规范的 commit 历史能让你在几分钟内定位引入问题的提交,这就是平时坚持规范的回报。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。