ERLI's Blog

Git 分支管理的实用方法

2026/10/11
loading

很多人觉得 Git 分支管理很复杂,实际上只要抓住几个核心原则,就不会再“乱开分支”。这篇文章记录一套比较实用的日常分支管理方式。

先说结论

最适合大多数个人项目和小团队的模式,是:

  • main:稳定主分支
  • dev:开发分支
  • feature/*:功能分支
  • fix/*:修复分支
  • hotfix/*:线上紧急修复

不要一上来就开很多分支,关键是要有清晰的职责边界。

1. 不要把主分支当“试验场”

main 或 master 应该始终保持可发布状态。也就是说,代码合并到主分支之前,至少需要经过一次检查和必要的测试。

如果你和别人要协作,主分支一旦有问题,会直接影响发布。保持稳定非常关键。

2. 功能分支应该短命

新需求或新特性,最好基于 dev 或 main 新建分支,例如:

1
git checkout -b feature/blog-theme

功能分支的好处是:

  • 代码变更单独管理
  • 便于回看和 review
  • 不影响其他开发中的功能

记住一点:功能分支最好在功能完成后尽快合并,避免长期存在导致维护成本上升。

3. 提交前先清一遍状态

在提交前,最好检查:

1
2
git status
git diff

这一步看似简单,但能避免很多“提交了半截代码”之类的问题。特别是前端和博客类项目,经常容易出现未保存文件、调试代码、临时日志残留的情况。

4. 提交信息要准确

提交信息不是随便写一个“update”,最好用准确的描述:

1
git commit -m "fix: resolve theme config loading issue"

如果你以后回看历史提交,清晰的提交信息会让你省很多时间。

5. 合并前做一次思考

不是所有分支都应该直接合并。尤其是当改动范围比较大时,需要评估:

  • 是否影响已有功能
  • 是否需要测试
  • 是否有兼容性问题
  • 是否有回滚成本

这部分其实和代码质量无关,而是工程管理的能力。对于个人项目来说,分支管理不是“为了管理而管理”,而是为了让自己更轻松地维护项目。

6. 个人项目也值得建立规则

很多人以为 Git 规则只适合团队,其实不是。即使是一个人维护的博客项目,也可以建立一些基本规则:

  • 不在主分支直接写实验性代码
  • 重要修改单独开分支
  • 提交前注意质量
  • 发布前在本地验证

这样做之后,你对项目的控制感会明显增强。

CATALOG
  1. 1. 先说结论
  2. 2. 1. 不要把主分支当“试验场”
  3. 3. 2. 功能分支应该短命
  4. 4. 3. 提交前先清一遍状态
  5. 5. 4. 提交信息要准确
  6. 6. 5. 合并前做一次思考
  7. 7. 6. 个人项目也值得建立规则