Git 分支完全指南：从入门到精通

前言

分支是 Git 最强大的功能之一，也是 Git 区别于其他版本控制系统的核心特性。掌握分支的使用，能够让你在开发过程中游刃有余，轻松管理多个功能开发、bug 修复和版本发布。

本文将带你全面理解 Git 分支的概念、操作和最佳实践，涵盖从基础到进阶的所有知识点。

一、分支概念理解

1.1 什么是分支？

在 Git 中，分支本质上是一个指向提交对象的可移动指针。这个简单的定义蕴含着 Git 分支设计的精髓：

• 轻量级：分支只是一个指针，不是文件的复制
• 快速：创建和切换分支几乎瞬间完成
• 灵活：指针可以随时移动到新的提交

1.2 分支的工作原理

Git 的分支实现不依赖于文件复制，而是通过引用机制：

提交 C ← 提交 B ← 提交 A ← main
                    ↓
                  feature

当你在 main 分支上创建 feature 分支时，Git 只是创建了一个新的指针指向同一个提交，而不是复制所有文件。

1.3 分支的优势

二、git branch 创建分支

2.1 基本创建命令

# 创建新分支（不切换）
git branch <branch-name>

# 创建并切换到新分支
git checkout -b <branch-name>

# Git 2.23+ 推荐方式
git switch -c <branch-name>

2.2 基于指定提交创建分支

# 基于历史提交创建分支
git branch <branch-name> <commit-hash>

# 基于远程分支创建本地分支
git branch <local-branch> origin/<remote-branch>

2.3 分支管理命令

# 列出所有本地分支
git branch

# 列出所有分支（包括远程）
git branch -a

# 查看分支包含的提交
git branch --contains <commit>

# 重命名分支
git branch -m <old-name> <new-name>

2.4 最佳实践

• 命名规范：使用有意义的分支名，如 feature/login、bugfix/header-issue
• 及时清理：合并后删除已完成的分支
• 分支策略：团队统一分支命名和工作流

三、git checkout 切换分支

3.1 基本切换命令

# 切换到已有分支
git checkout <branch-name>

# Git 2.23+ 推荐方式
git switch <branch-name>

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

3.2 切换分支的条件

切换分支前，Git 会检查：

1. 工作区是否干净：有未提交的更改可能阻止切换
2. 目标分支是否存在：分支名必须存在
3. 文件冲突检查：工作区文件与目标分支冲突时会阻止切换

3.3 处理未提交更改

# 方案 1：提交更改
git add .
git commit -m "WIP: 临时提交"
git checkout <branch>

# 方案 2：使用 stash 暂存
git stash
git checkout <branch>
git stash pop

# 方案 3：强制切换（会丢失更改）
git checkout -f <branch>

3.4 注意事项

警告 重要：切换分支会更新工作区文件，确保重要更改已提交或暂存！

四、git merge 合并分支

4.1 合并的基本概念

合并是将一个分支的更改集成到当前分支的操作：

# 将 feature 分支合并到当前分支
git merge feature

4.2 合并策略

Fast-Forward 合并

当当前分支落后于目标分支时，Git 会进行快进合并：

合并前：
main: A ← B
feature: A ← B ← C ← D

合并后：
main: A ← B ← C ← D
      ↑
   feature

特点：不创建合并提交，只是移动指针

Three-Way Merge（三方合并）

当两个分支有分歧时，Git 会创建合并提交：

合并前：
        C ← D (feature)
       /
A ← B
       
        E (main)

合并后：
        C ← D
       /     
A ← B         M (合并提交)
            /
        E

特点：创建新的合并提交，有两个父提交

4.3 合并参数

# 强制创建合并提交（禁用快进）
git merge --no-ff feature

# 压缩合并（多个提交合并为一个）
git merge --squash feature

# 中止正在进行的合并
git merge --abort

# 不自动提交，手动处理
git merge --no-commit feature

4.4 解决合并冲突

当两个分支修改了同一文件的同一部分时，会产生冲突：

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

解决步骤：

1. 编辑冲突文件，保留需要的内容
2. git add <file> 标记为解决
3. git commit 完成合并

五、git branch -d 删除分支

5.1 安全删除

# 删除已合并的分支（安全）
git branch -d <branch-name>

Git 会检查分支是否已合并，未合并的分支会拒绝删除。

5.2 强制删除

# 强制删除未合并的分支
git branch -D <branch-name>

警告 警告：这会丢失该分支独有的提交！

5.3 删除限制

以下情况无法删除分支：

1. 当前所在分支：不能删除当前检出的分支
2. 未完全合并：分支包含未合并到其他分支的提交（使用 -d 时）

5.4 分支恢复

如果误删了分支，可以通过 reflog 恢复：

# 查看 reflog
git reflog

# 找到删除前的提交 hash
# 重新创建分支
git branch <branch-name> <commit-hash>

六、HEAD 指针理解

6.1 什么是 HEAD？

HEAD 是一个特殊指针，指向当前所在的分支。它存储在 .git/HEAD 文件中。

# 正常状态（附加到分支）
ref: refs/heads/main

# 分离 HEAD 状态（直接指向提交）
a1b2c3d4e5f6...

6.2 分离 HEAD 状态

当 HEAD 直接指向提交而非分支时，称为分离 HEAD 状态：

# 进入分离 HEAD 状态
git checkout <commit-hash>

# 或者
git checkout HEAD~1

6.3 分离 HEAD 的风险

在分离 HEAD 状态下：

• √ 可以查看历史提交
• √ 可以进行提交
• 警告 切换回分支后，提交会变成悬空提交
• 警告 悬空提交最终会被垃圾回收

6.4 处理分离 HEAD

# 如果有需要保留的提交，创建新分支
git checkout -b new-branch

# 如果没有需要保留的提交，直接切换
git checkout main

# 使用 reflog 找回悬空提交
git reflog
git branch recovered-branch <commit-hash>

6.5 HEAD 的常用操作

# 查看 HEAD 指向
cat .git/HEAD

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

# 查看 HEAD 的历史
git reflog show HEAD

七、实战练习

7.1 标准开发流程

# 1. 从 main 创建功能分支
git checkout main
git pull origin main
git checkout -b feature/new-feature

# 2. 开发功能
# ... 编写代码 ...
git add .
git commit -m "feat: 实现新功能"

# 3. 同步 main 分支的最新更改
git checkout main
git pull origin main
git checkout feature/new-feature
git merge main

# 4. 完成开发，合并回 main
git checkout main
git merge --no-ff feature/new-feature
git push origin main

# 5. 清理功能分支
git branch -d feature/new-feature

7.2 常见场景处理

场景 1：紧急 bug 修复

# 基于当前发布版本创建 hotfix 分支
git checkout -b hotfix/urgent-fix v1.0.0
# 修复 bug
git commit -m "fix: 修复紧急问题"
# 合并回 main 和 develop
git checkout main
git merge hotfix/urgent-fix

场景 2：放弃某个功能

# 直接删除功能分支
git checkout main
git branch -D feature/abandoned

八、最佳实践总结

8.1 分支命名规范

8.2 提交规范

• 使用清晰的提交信息
• 一个提交只做一件事
• 及时提交，避免大提交

8.3 合并策略

• 功能分支使用 --no-ff 保留历史
• hotfix 分支直接快进合并
• 定期同步 main 分支，减少冲突

8.4 清理习惯

• 合并后及时删除分支
• 定期清理过期分支
• 使用 git remote prune origin 清理远程引用

九、常见问题解答

Q1: 分支和标签有什么区别？

分支是可移动的指针，会随着新提交而更新；标签是固定的指针，指向特定提交后不会改变。

Q2: 可以删除 main 分支吗？

技术上可以，但强烈不建议。main/master 是默认主分支，删除会导致仓库混乱。

Q3: 合并和变基（rebase）选哪个？

• 合并：保留完整历史，适合公共分支
• 变基：整理提交历史，适合本地功能分支

Q4: 如何查看两个分支的差异？

git diff branch1..branch2

十、总结

Git 分支是 Git 最强大的功能，掌握分支操作能够：

√ 提高开发效率 √ 降低代码冲突风险 √ 支持并行开发 √ 便于版本管理

核心要点回顾：

1. 分支是指针，创建和切换非常快
2. 使用 git branch 创建和管理分支
3. 使用 git checkout 或 git switch 切换分支
4. 使用 git merge 合并分支
5. 使用 git branch -d 安全删除分支
6. 理解 HEAD 指针和分离 HEAD 状态

继续学习：

• 进阶：Git 变基（rebase）详解
• 进阶：Git 工作流（Git Flow、GitHub Flow）
• 实战：团队协作中的分支管理

祝你 Git 使用愉快！