Git 分支管理

知识点地图#

• 知识类别：Git 分支管理——分支的创建/切换/合并/删除操作、命名规范与团队分支策略选型。
• 解决什么问题：多人（或多任务）并行开发时互不踩脚：功能开发、紧急修复、发布准备各自有独立分支，合并时才有节奏地汇流。分支的「本质是指针」原理见 110 篇；工作流模型（Git Flow/GitHub Flow 的完整展开）见 210 篇；合并冲突的完整解剖见 130 篇。
• 什么时候用到：开新任务前建分支；完成后合并回主线；接手仓库先看分支布局；团队制定分支策略时选型。

2. 分支概述#

分支是 Git 中非常重要的概念，它允许你在独立的环境中开发新功能或修复 bug，而不影响主分支的稳定性。 分支的核心特点：

• 分支是指向特定提交的指针
• 默认分支为 main（GitHub 约定；未配置的旧版 Git 可能生成 master，用 git branch -M main 纠正）
• 分支操作轻量快速
• 支持并行开发
• 便于代码审查和测试

3. 分支操作基础#

3.1 查看分支#

 # 查看本地分支
 git branch
 # 查看远程分支
 git branch -r
 # 查看所有分支（本地和远程）
 git branch -a
 # 查看分支及其最后一次提交
 git branch -v

3.2 创建分支#

 # 创建新分支
 git branch <分支名>

3.3 切换分支#

 # 切换分支
 git checkout <分支名>
 # 或 Git 2.23+ 推荐
 git switch <分支名>

3.4 创建并切换分支#

 # 创建并切换分支
 git checkout -b <分支名>
 # 或 Git 2.23+ 推荐
 git switch -c <分支名>

3.5 合并分支#

 # 合并分支到当前分支
 git merge <分支名>
 # 快速合并（Fast-forward）
 # 当主分支没有新提交时，会执行快速合并
 git checkout main
 git merge feature/login
 # 三方合并（3-way merge）
 # 当主分支有新提交时，会执行三方合并
 git checkout main
 git merge feature/payment

3.5.1 合并策略

 # 使用策略合并
 git merge --strategy-option theirs feature/branch # 优先使用对方分支的修改
 git merge --strategy-option ours feature/branch # 优先使用当前分支的修改
 # 递归策略（默认）
 git merge --strategy recursive feature/branch
 # 章鱼策略（适合合并多个分支）
 git merge --strategy octopus feature1 feature2 feature3
 # 分支多时可用反斜杠换行书写，可读性更好
 git merge --strategy octopus feature1 \
                           feature2 \
                           feature3

易错点：--strategy-option ours 与 merge=ours 驱动（见 045 篇）名字相像但完全是两回事——前者只在冲突块上偏袒当前分支，非冲突修改照常合并；后者是整文件级别的「以我为准」。想要「冲突时自动选对方」的 theirs 同理只作用于冲突处。

3.6 删除分支#

 # 删除分支（仅当分支已合并）
 git branch -d <分支名>
 # 强制删除分支（无论是否合并）
 git branch -D <分支名>
 # 删除远程分支
 git push <远程仓库名> --delete <分支名>

3.7 重命名分支#

 # 重命名分支
 git branch -m <旧分支名> <新分支名>

3.8 设置上游分支#

 # 设置分支的上游分支
 git branch --set-upstream-to=origin/<远程分支名> <本地分支名>
 # 首次推送时设置上游分支
 git push -u <远程仓库名> <本地分支名>

4. 分支命名规范#

5. 分支管理策略#

5.1 集中式工作流#

• 所有开发者直接在主分支上工作
• 适合小型团队和简单项目
• 优点：简单直接
• 缺点：容易产生冲突，不利于代码审查

5.2 功能分支工作流#

• 为每个功能创建单独的分支
• 完成后合并到主分支
• 适合大多数项目
• 优点：隔离开发，便于代码审查
• 缺点：需要更多的分支管理

5.3 GitFlow 工作流#

GitFlow 是一种详细的分支管理策略，适合大型项目和复杂的发布周期。

5.3.1 GitFlow 分支结构

• main/master：主分支，保持稳定，只用于发布
• develop：开发分支，集成所有功能分支
• feature/：功能分支，从 develop 分支创建
• release/：发布分支，从 develop 分支创建
• hotfix/：热修复分支，从 main 分支创建

5.3.2 GitFlow 工作流程

1. 初始化：创建 main 和 develop 分支
2. 功能开发：从 develop 创建 feature 分支，完成后合并回 develop
3. 发布准备：从 develop 创建 release 分支，进行测试和修复
4. 发布：将 release 分支合并到 main 和 develop
5. 热修复：从 main 创建 hotfix 分支，完成后合并到 main 和 develop

5.3.3 GitFlow 示例

 # 初始化 GitFlow
 git flow init
 # 创建功能分支
 git flow feature start login
 # 完成功能分支
 git flow feature finish login
 # 创建发布分支
 git flow release start v1.0.0
 # 完成发布分支
 git flow release finish v1.0.0
 # 创建热修复分支
 git flow hotfix start security-patch
 # 完成热修复分支
 git flow hotfix finish security-patch

5.4 Forking 工作流#

• 开发者 fork 远程仓库
• 在自己的 fork 中工作
• 通过 Pull Request 贡献代码
• 适合开源项目
• 优点：适合多人协作，权限管理简单
• 缺点：流程相对复杂

6. 解决分支冲突#

当合并分支时，如果两个分支对同一文件的同一部分进行了不同修改，就会产生冲突。 解决冲突的步骤：

1. 查看冲突文件：

 git diff

2. 手动编辑冲突文件： 冲突文件中会包含以下标记：

 <<<<<<<< HEAD
 当前分支的内容
 =======
 要合并的分支的内容
 >>>>>>> 分支名

手动编辑文件，保留需要的内容，删除冲突标记。3. 添加解决后的文件：

 git add .

4. 完成合并：

 git commit

5. 放弃合并（如果需要）：

 git merge --abort

7. 分支最佳实践#

7.1 分支管理最佳实践#

1. 主分支保持稳定：

• 主分支只用于发布
• 不直接在主分支上开发
• 所有修改通过分支合并

2. 使用功能分支：

• 为每个功能创建单独的分支
• 分支名清晰描述功能
• 分支生命周期与功能开发周期一致

3. 定期同步：

• 定期将主分支合并到功能分支
• 减少冲突概率
• 确保功能分支包含最新代码

4. 及时清理：

• 功能完成后删除对应的分支
• 保持分支列表整洁
• 定期清理远程分支

5. 分支策略选择：

• 小型项目：集中式或功能分支工作流
• 中型项目：功能分支工作流
• 大型项目：GitFlow 工作流
• 开源项目：Forking 工作流

6. 代码审查：

• 使用 Pull Request 进行代码审查
• 确保代码质量
• 多人参与审查

7.2 实际项目案例#

7.2.1 小型项目（个人或小团队）

 # 初始化仓库
 git init
 # 创建并切换到功能分支
 git checkout -b feature/login
 # 开发完成后合并到主分支
 git checkout main
 git merge feature/login
 # 删除功能分支
 git branch -d feature/login

7.2.2 中型项目（团队协作）

 # 从远程仓库克隆
 git clone <远程仓库URL>
 # 创建功能分支
 git checkout -b feature/payment
 # 定期同步主分支
 git checkout feature/payment
 git pull origin main
 # 完成后推送到远程
 git push origin feature/payment
 # 创建 Pull Request 进行代码审查
 # 合并后删除本地分支
 git branch -d feature/payment

7.2.3 大型项目（GitFlow）

 # 初始化 GitFlow
 git flow init
 # 创建功能分支
 git flow feature start user-profile
 # 开发完成
 git flow feature finish user-profile
 # 创建发布分支
 git flow release start v2.0.0
 # 完成发布
 git flow release finish v2.0.0
 # 紧急修复
 git flow hotfix start critical-bug

8. 总结#

分支管理是 Git 的核心功能之一，通过合理的分支管理，可以提高开发效率，减少冲突，确保代码质量。

• 分支操作：掌握创建、切换、合并、删除分支的基本操作
• 分支命名：遵循规范的分支命名约定
• 分支策略：根据项目特点选择合适的分支管理策略
• 冲突解决：掌握解决分支冲突的方法
• 最佳实践：遵循分支管理的最佳实践 通过熟练掌握分支管理，可以更好地组织代码开发流程，提高团队协作效率。

动手实践#

练习 1：模拟一个两分支汇合：从 main 建 feature/login 提交两次，期间 main 也前进一个提交，然后合并——观察这次合并为什么不是 fast-forward；再建一个 main 没有前进的分支验证 fast-forward 的触发条件。

提示：git log --graph --oneline --all 能直观看到合并拓扑；git merge 输出的第一行会写明走的是哪种合并。

练习 2：故意制造一次冲突（两个分支改同一行），用 3.6 的流程解决；解决后用 git log -1 --format=%P 看合并提交的双亲，理解「合并提交记录了双方」。

提示：冲突时 git status 列出 both modified 文件；解决一半想重来用 git merge --abort。

练习 3：审查一个真实仓库的分支：列出本地与远程分支、找出已合并可删的分支（git branch --merged main）并删除，体会「及时清理」的实践含义。

# 练习 1
git init br-lab && cd br-lab
echo base > f.txt && git add f.txt && git commit -m "base"
git switch -c feature/login
echo login1 > login.txt && git add . && git commit -m "login 1"
git switch main && echo main1 > m.txt && git add . && git commit -m "main 1"
git switch feature/login && echo login2 >> login.txt && git commit -am "login 2"
git switch main && git merge feature/login
# 输出含 "Merge made by the 'ort' strategy"：main 已前进，非 fast-forward

git switch -c quickfix && echo fix > q.txt && git add . && git commit -m "quick"
git switch main && git merge quickfix
# 输出含 "Fast-forward"：main 未动，指针直接前移

# 练习 2
git switch -c conflict-a && echo A > c.txt && git add . && git commit -m "A"
git switch main && git switch -c conflict-b
git switch main && echo B > c.txt && git add . && git commit -m "B"
git merge conflict-a            # 冲突
git status --short              # UU c.txt
# 编辑 c.txt 保留想要的内容后
git add c.txt && git commit --no-edit
git log -1 --format=%P          # 输出两个哈希：双亲提交

# 练习 3
git branch -a
git branch --merged main        # 已并入 main、可安全删除的分支
git branch -d <分支名>