代码协作里,最便宜的质量保障就是"分支规范 + 评审"。不需要复杂流程,几条简单规则就能让主干长期可发布。

分支模型

  • main:唯一可发布分支,永远保持可部署状态。
  • feature/xxx:从 main 切出,一个功能一条分支,做完即合即删。
  • fix/xxx:紧急修复同理,命名清晰即可。

一次标准提交

# 从最新 main 切分支
git checkout main && git pull
git checkout -b feature/site-footer

# 改动后提交(信息讲清"为什么")
git commit -m "fix: 页脚备案号增加工信部超链接

初审要求备案号可点击跳转 beian.miit.gov.cn"

提交信息规范

采用 类型: 简述 前缀,类型常用:

  • feat 新功能 · fix 修复 · docs 文档
  • style 格式 · refactor 重构 · chore 杂项

正文写"为什么改"而非"改了什么"——代码本身已说明 What,提交信息该承载 Why。

合并前自检

  1. 本地能正常构建/打开,无遗留调试代码。
  2. 自测清单逐项通过(命名、错误路径、边界)。
  3. 发起 PR,描述"做了什么、怎么验证",请同伴评审后再合。
原则:主干不能被"临时改坏"。任何合并都应是可回滚的、经过验证的。