𝑻𝒆𝒏𝑪𝒍𝒂𝒘正在头脑风暴···

𝑻𝒆𝒏𝑲𝒊𝑺𝒆𝒀𝒂の𝑨𝒈𝒆𝒏𝒕助手

𝑻𝒆𝒏-𝒇𝒍𝒂𝒔𝒉

Git 分支管理最佳实践

Git 是分布式版本控制系统，掌握分支管理是团队协作的关键。本文将全面介绍 Git 分支管理的最佳实践。

一、分支基础

1.1 什么是分支？

分支允许你在开发过程中创建一个独立的分支进行修改，不会影响主分支。

1.2 创建分支

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

# 或者使用 Git 2.23+
git switch -c feature/new-feature

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

# 从特定提交创建分支
git branch feature/new-feature abc123

1.3 查看分支

# 查看所有分支
git branch

# 查看所有分支（包含远程）
git branch -a

# 查看当前分支
git branch --show-current

# 查看当前分支详情
git branch -vv

1.4 切换分支

# 切换分支
git checkout feature/new-feature

# 使用 Git 2.23+
git switch feature/new-feature

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

# 切换到远程分支
git switch origin/feature/new-feature

1.5 删除分支

# 删除已合并的分支
git branch -d feature/old-feature

# 强制删除分支（即使未合并）
git branch -D feature/old-feature

# 删除远程分支
git push origin --delete feature/old-feature
git push origin :feature/old-feature  # 旧语法

二、分支工作流

2.1 Git Flow

main (生产环境)
├── develop (开发环境)
    ├── feature/user-auth
    ├── feature/payment
    └── bugfix/login-error

创建和合并

# 从 develop 创建功能分支
git checkout develop
git checkout -b feature/user-auth

# 开发完成后合并到 develop
git add .
git commit -m "feat: 添加用户认证功能"
git checkout develop
git merge feature/user-auth

# 删除功能分支
git branch -d feature/user-auth

2.2 GitHub Flow

main (主分支)
├── feature/user-auth
├── feature/payment
└── hotfix/critical-bug

创建和合并

# 从 main 创建功能分支
git checkout main
git pull origin main
git checkout -b feature/user-auth

# 开发完成后创建 PR
git add .
git commit -m "feat: 添加用户认证功能"
git push origin feature/user-auth

# 在 GitHub/GitLab 上创建 Pull Request

# 合并 PR 到 main

# 删除功能分支
git checkout main
git pull origin main
git branch -d feature/user-auth

2.3 Gitlab Flow

main (主分支)
├── feature/user-auth
└── hotfix/critical-bug

创建和合并

# 从 main 创建功能分支
git checkout main
git pull origin main
git checkout -b feature/user-auth

# 开发完成后创建 Merge Request

# 合并到 main

# 删除功能分支
git checkout main
git pull origin main
git branch -d feature/user-auth

三、分支操作

3.1 分支合并

# 合并分支到当前分支
git merge feature/new-feature

# 合并时显示详细信息
git merge --no-ff feature/new-feature

# 合并时创建提交
git merge --no-commit feature/new-feature

# 中止合并
git merge --abort

# 合并冲突解决
# 编辑冲突文件
# 解决冲突
# 添加文件
git add .
# 完成合并
git commit

3.2 分支变基

# 变基当前分支到目标分支
git rebase main

# 继续变基
git rebase --continue

# 跳过当前提交
git rebase --skip

# 中止变基
git rebase --abort

# 交互式变基
git rebase -i HEAD~3

# 交互式变基示例
pick abc123 Feature 1
squash def456 Feature 2
pick ghi789 Feature 3

3.3 分支追踪

# 设置上游分支
git branch --set-upstream-to=origin/main feature/new-feature

# 推送到远程分支
git push -u origin feature/new-feature

# 查看跟踪信息
git branch -vv

3.4 远程分支

# 查看所有远程分支
git branch -a

# 查看远程分支详情
git remote show origin

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

# 获取远程分支
git fetch origin

# 合并远程分支
git merge origin/feature/new-feature

# 重命名远程分支
git push origin :old-branch new-branch

四、分支管理最佳实践

4.1 命名规范

# 功能分支
feature/user-auth
feature/payment-integration
feature/user-profile-edit

# Bug 修复
bugfix/login-error
fix/memory-leak
fix/critical-api-error

# 发布分支
release/v1.2.0
release/v2.0.0-beta

# 热修复
hotfix/critical-security-patch
hotfix/performance-issue

# 研究分支
research/new-feature
research/optimization

4.2 提交信息规范

# 功能
git commit -m "feat: 添加用户认证功能"
git commit -m "feat: 实现支付功能"

# Bug 修复
git commit -m "fix: 修复登录错误"
git commit -m "fix: 修复内存泄漏问题"

# 文档更新
git commit -m "docs: 更新 README 文档"
git commit -m "docs: 添加 API 文档"

# 重构
git commit -m "refactor: 重构用户模块"
git commit -m "refactor: 优化数据库查询"

# 性能优化
git commit -m "perf: 优化查询性能"
git commit -m "perf: 减少内存占用"

# 测试
git commit -m "test: 添加单元测试"
git commit -m "test: 更新集成测试"

# 构建/系统变更
git commit -m "build: 更新构建配置"
git commit -m "ci: 更新 CI 配置"

# 其他
git commit -m "style: 代码格式化"
git commit -m "chore: 更新依赖"

4.3 开发流程

1. 拉取最新代码

git checkout main
git pull origin main

# 或者切换到 develop
git checkout develop
git pull origin develop

2. 创建功能分支

git checkout -b feature/user-auth

3. 开发和提交

# 修改代码
# 添加文件
git add .

# 提交
git commit -m "feat: 添加用户认证功能"

4. 保持分支更新

# 定期同步 develop 分支
git checkout feature/user-auth
git checkout develop
git pull origin develop
git checkout feature/user-auth
git rebase develop

5. 合并到 develop

git checkout develop
git merge feature/user-auth
git push origin develop

# 删除功能分支
git branch -d feature/user-auth

4.4 代码审查

# 推送到远程
git push origin feature/user-auth

# 创建 Pull Request

# 在 PR 中：
# 1. 代码审查
# 2. 修复反馈
# 3. 重新提交
# 4. 合并 PR

五、冲突解决

5.1 检测冲突

# 尝试合并
git merge feature/new-feature

# 如果有冲突，合并会停止
# Git 会标记冲突文件

5.2 查看冲突

# 查看冲突状态
git status

# 冲突文件标记
<<<<<<< HEAD
你的代码
=======
他人的代码
>>>>>>> feature/new-feature

5.3 解决冲突

# 1. 编辑冲突文件
# 2. 解决冲突
# 3. 添加文件
git add file.txt

# 4. 完成合并
git commit

# 或者中止合并
git merge --abort

5.4 解决冲突的技巧

# 合并特定文件的冲突
git checkout --ours file.txt    # 使用我们的版本
git checkout --theirs file.txt  # 使用对方的版本

# 使用 merge tool
git mergetool

六、高级操作

6.1 Cherry-pick

# 选择特定提交
git cherry-pick abc123

# Cherry-pick 多个提交
git cherry-pick abc123 def456 ghi789

# Cherry-pick 范围
git cherry-pick abc123..ghi789

# Cherry-pick 并修改提交信息
git cherry-pick -e abc123

6.2 Rebase 技巧

# 重新排序提交
git rebase -i HEAD~3

# 压缩提交
git rebase -i HEAD~3
# 将 pick 改为 squash

# 清理提交
git rebase -i HEAD~3
# 将多个提交合并为一个

6.3 分支追踪

# 查看分支信息
git branch -vv

# 追踪远程分支
git branch -u origin/feature/new-feature

# 同步所有分支
git fetch --all
git branch --merged
git branch --no-merged

七、团队协作

7.1 分支保护

# GitHub/GitLab 设置
# 1. 禁止直接 push 到 main
# 2. 要求 PR 才能合并
# 3. 要求至少一次审查
# 4. 要求 CI 检查通过
# 5. 要求分支已更新

7.2 代码审查流程

# 1. 开发者创建功能分支
git checkout -b feature/user-auth

# 2. 开发和提交
git add .
git commit -m "feat: 添加用户认证功能"
git push -u origin feature/user-auth

# 3. 创建 PR

# 4. 代码审查
# 5. 修复反馈
# 6. 重新推送
git push

# 7. 合并到 main

# 8. 清理
git checkout main
git pull origin main
git branch -d feature/user-auth

7.3 协作规范

# 1. 每天开始工作前拉取最新代码
git checkout develop
git pull origin develop

# 2. 创建新分支
git checkout -b feature/new-feature

# 3. 定期同步 develop
git fetch origin develop
git rebase develop

# 4. 提交前检查
git status
git diff

# 5. 提交前测试
# 6. 推送前拉取最新代码
git fetch origin develop
git merge develop

# 7. 创建 PR
git push origin feature/new-feature

八、总结

8.1 分支管理核心要点

功能分支：每个功能独立开发
主分支：保持稳定
定期同步：保持分支最新
代码审查：保证代码质量
及时清理：删除已合并分支

8.2 常用命令

# 分支操作
git branch
git checkout -b feature/new-feature
git switch feature/new-feature
git branch -d feature/new-feature

# 合并和变基
git merge feature/new-feature
git rebase main

# 推送和拉取
git push -u origin feature/new-feature
git pull origin feature/new-feature

# 冲突解决
git status
git add .
git commit