Git 分支完全指南

Git 分支完全指南

_

一、分支有什么用?

作用

说明

并行开发

多人同时开发不同功能,互不干扰

风险隔离

新功能在独立分支开发,不影响主分支稳定性

代码管理

每个功能一个分支,便于追溯和管理

Code Review

通过合并请求进行代码审查

版本控制

同时维护多个版本(如 v1.0 稳定版,v2.0 开发版)


二、常见分支命名规范

1. 主要分支

main / master     # 主分支,生产环境代码,保持稳定
develop           # 开发分支,集成最新开发功能

2. 辅助分支

feature/xxx       # 新功能分支
fix/xxx           # Bug 修复分支
hotfix/xxx        # 紧急修复分支
release/x.x.x     # 发布版本分支

3. 示例

main              # 主分支
develop           # 开发分支
feature/user-auth # 用户认证功能
fix/login-bug     # 登录 Bug 修复
hotfix/security-fix # 紧急安全修复
release/v1.2.0   # v1.2.0 版本发布

三、分支操作命令

创建分支

# 创建并切换到新分支
git checkout -b feature/new-feature

# 或使用 switch 命令(Git 2.23+)
git switch -c feature/new-feature

# 只创建分支,不切换
git branch feature/new-feature

查看分支

# 查看本地分支
git branch

# 查看所有分支(包括远程)
git branch -a

# 查看远程分支
git branch -r

# 查看分支详细信息(最后提交)
git branch -v

# 查看分支合并关系图
git log --graph --oneline --all

切换分支

# 切换到已有分支
git checkout develop
# 或
git switch develop

# 切换到上一个分支
git checkout -

删除分支

# 删除本地分支(已合并)
git branch -d feature/old-feature

# 强制删除本地分支(未合并)
git branch -D feature/old-feature

# 删除远程分支
git push origin --delete feature/old-feature

合并分支

# 切换到目标分支
git checkout main

# 合并指定分支
git merge feature/new-feature

# 如果使用 rebase(保持线性历史)
git checkout main
git rebase feature/new-feature

四、常见分支工作流

1. Git Flow(经典模型)

main (生产)
  ↓
release (发布)
  ↓
develop (开发)
  ↓
feature/* (功能)

2. GitHub Flow(简化模型)

main (生产)
  ↓
feature/* (功能) → Pull Request → 合并到 main

3. 本项目推荐流程

develop (开发主分支)
  ↓
feature/xxx (功能分支) → 合并到 develop

根据你的项目,当前分支是 develop,建议:

  • develop 创建功能分支

  • 开发完成后合并回 develop


五、实际操作示例

# 1. 确保在 develop 分支且是最新的
git checkout develop
git pull origin develop

# 2. 创建功能分支
git checkout -b feature/add-user-profile

# 3. 开发、提交
git add .
git commit -m "feat: 添加用户资料页面"

# 4. 推送到远程
git push -u origin feature/add-user-profile

# 5. 开发完成后,合并回 develop
git checkout develop
git merge feature/add-user-profile
git push origin develop

# 6. 删除功能分支(可选)
git branch -d feature/add-user-profile
git push origin --delete feature/add-user-profile

六、分支管理最佳实践

原则

说明

短生命周期

功能分支完成后及时删除,避免堆积

定期同步

定期从主分支拉取更新,减少冲突

明确命名

使用 feature/fix/ 前缀,一目了然

一个功能一个分支

避免在同一个分支开发多个功能

保持主分支稳定

main 分支应始终可部署


Windows 下使用 Jabba 管理 Java 版本 2026-02-24
Git 同时推送到多个远程仓库(阿里云效 + GitHub) 2026-02-12

评论区