Git Merge

合并是 Git 中将不同分支的更改整合到一起的核心操作。本章将详细介绍各种合并策略、冲突解决和最佳实践。

合并基础概念

什么是合并？

合并是将一个分支的更改集成到另一个分支的过程。Git 提供了多种合并策略来处理不同的场景。

合并前:
A---B---C  (main)
     \
      D---E  (feature)

合并后:
A---B---C---F  (main)
     \     /
      D---E    (feature)

合并的类型

快进合并 (Fast-forward)：目标分支没有新提交
三方合并 (Three-way merge)：两个分支都有新提交
压缩合并 (Squash merge)：将多个提交压缩为一个

基本合并操作

准备演示环境

# 创建演示项目
mkdir git-merge-demo
cd git-merge-demo
git init

# 创建初始提交
echo "# 合并演示项目" > README.md
git add README.md
git commit -m "初始提交"

# 创建并切换到功能分支
git checkout -b feature/user-login
echo "登录功能" > login.js
git add login.js
git commit -m "添加登录功能"

echo "登录样式" > login.css
git add login.css
git commit -m "添加登录样式"

快进合并

当目标分支（通常是 main）没有新的提交时，Git 会进行快进合并：

# 切换回主分支
git checkout main

# 执行快进合并
git merge feature/user-login

输出：

Updating a1b2c3d..e4f5g6h
Fast-forward
 login.css | 1 +
 login.js  | 1 +
 2 files changed, 2 insertions(+)
 create mode 100644 login.css
 create mode 100644 login.js

快进合并的特点：

不创建新的合并提交
历史保持线性
分支指针直接移动

禁用快进合并

# 强制创建合并提交
git merge --no-ff feature/user-login

# 这会创建一个合并提交，即使可以快进

三方合并

创建三方合并场景

# 在主分支上添加提交
git checkout main
echo "主分支更新" >> README.md
git add README.md
git commit -m "更新 README"

# 创建新的功能分支
git checkout -b feature/user-register
echo "注册功能" > register.js
git add register.js
git commit -m "添加注册功能"

# 切换回主分支并合并
git checkout main
git merge feature/user-register

Git 会自动创建合并提交：

Merge made by the 'recursive' strategy.
 register.js | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 register.js

自定义合并提交信息

# 合并时指定提交信息
git merge feature/user-register -m "合并用户注册功能"

# 合并时编辑提交信息
git merge feature/user-register --edit

合并策略

递归策略 (Recursive)

这是 Git 的默认合并策略，适用于大多数情况：

# 显式指定递归策略
git merge -s recursive feature/branch-name

# 递归策略的选项
git merge -s recursive -X ours feature/branch-name      # 冲突时优先使用当前分支
git merge -s recursive -X theirs feature/branch-name    # 冲突时优先使用合并分支
git merge -s recursive -X ignore-space-change feature/branch-name  # 忽略空白字符变化

Octopus 策略

用于合并多个分支：

# 同时合并多个分支
git merge branch1 branch2 branch3

Ours 策略

保留当前分支的内容，忽略其他分支的更改：

# 使用 ours 策略
git merge -s ours feature/branch-name

Subtree 策略

用于子树合并：

# 子树合并
git merge -s subtree feature/branch-name

处理合并冲突

识别冲突

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

# 创建冲突场景
git checkout main
echo "主分支的配置" > config.txt
git add config.txt
git commit -m "添加主分支配置"

git checkout -b feature/config-update
echo "功能分支的配置" > config.txt
git add config.txt
git commit -m "更新配置文件"

# 尝试合并（会产生冲突）
git checkout main
git merge feature/config-update

冲突输出：

Auto-merging config.txt
CONFLICT (content): Merge conflict in config.txt
Automatic merge failed; fix conflicts and then commit the result.

查看冲突状态

# 查看冲突状态
git status

# 查看冲突文件
git diff

# 查看冲突的详细信息
git diff --name-only --diff-filter=U

冲突标记解释

冲突文件会包含特殊标记：

<<<<<<< HEAD
主分支的配置
=======
功能分支的配置
>>>>>>> feature/config-update

标记说明：

<<<<<<< HEAD：当前分支的内容开始
=======：分隔符
>>>>>>> branch-name：合并分支的内容结束

手动解决冲突

# 编辑冲突文件，选择保留的内容
echo "合并后的配置" > config.txt

# 标记冲突已解决
git add config.txt

# 完成合并
git commit

使用合并工具

# 启动默认合并工具
git mergetool

# 使用特定合并工具
git mergetool --tool=vimdiff
git mergetool --tool=vscode

# 配置默认合并工具
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'

冲突解决策略

# 选择当前分支的版本
git checkout --ours conflicted_file.txt
git add conflicted_file.txt

# 选择合并分支的版本
git checkout --theirs conflicted_file.txt
git add conflicted_file.txt

# 查看不同版本
git show :1:conflicted_file.txt  # 共同祖先版本
git show :2:conflicted_file.txt  # 当前分支版本
git show :3:conflicted_file.txt  # 合并分支版本

高级合并操作

压缩合并 (Squash Merge)

将功能分支的所有提交压缩为一个提交：

# 压缩合并
git merge --squash feature/user-profile

# 需要手动提交
git commit -m "添加用户资料功能"

压缩合并的特点：

保持主分支历史简洁
丢失功能分支的详细历史
适合功能完整后的合并

部分合并

# 只合并特定文件
git checkout feature/branch-name -- specific_file.txt
git commit -m "合并特定文件"

# 合并特定提交
git cherry-pick commit_hash

合并特定提交范围

# 合并一系列提交
git cherry-pick start_commit..end_commit

# 合并多个不连续的提交
git cherry-pick commit1 commit2 commit3

撤销合并

撤销未推送的合并

# 撤销最后一次合并
git reset --hard HEAD~1

# 撤销合并但保留工作区更改
git reset --soft HEAD~1

# 撤销合并但保留暂存区
git reset --mixed HEAD~1

撤销已推送的合并

# 创建反向合并提交
git revert -m 1 merge_commit_hash

# -m 1 表示保留第一个父提交（通常是主分支）
# -m 2 表示保留第二个父提交（通常是功能分支）

查找合并提交

# 查看合并历史
git log --merges

# 查看特定合并的详细信息
git show merge_commit_hash

# 查看合并引入的更改
git diff merge_commit_hash^1 merge_commit_hash

合并最佳实践

1. 合并前的准备

# 确保工作区干净
git status

# 更新目标分支
git checkout main
git pull origin main

# 确保功能分支是最新的
git checkout feature/branch-name
git rebase main  # 或者 git merge main

2. 选择合适的合并策略

# 小功能或修复：快进合并
git merge feature/small-fix

# 大功能：非快进合并，保留分支历史
git merge --no-ff feature/major-feature

# 实验性功能：压缩合并
git merge --squash feature/experimental

3. 编写清晰的合并信息

# 好的合并信息示例
git merge feature/user-auth -m "
合并用户认证功能

- 添加登录/注册页面
- 实现 JWT 认证
- 添加用户权限管理
- 更新相关测试

Closes #123
"

4. 合并后的清理

# 删除已合并的本地分支
git branch -d feature/merged-branch

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

# 清理远程分支引用
git remote prune origin

合并工作流

GitHub Flow

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

# 2. 开发并提交
git add .
git commit -m "实现新功能"

# 3. 推送分支
git push origin feature/new-feature

# 4. 创建 Pull Request
# 5. 代码审查
# 6. 合并到 main
git checkout main
git merge --no-ff feature/new-feature

# 7. 清理分支
git branch -d feature/new-feature
git push origin --delete feature/new-feature

Git Flow

# 功能开发流程
git checkout develop
git checkout -b feature/new-feature

# 开发完成后
git checkout develop
git merge --no-ff feature/new-feature
git branch -d feature/new-feature

# 发布流程
git checkout -b release/1.0.0 develop
# 修复发布相关问题
git checkout main
git merge --no-ff release/1.0.0
git tag v1.0.0
git checkout develop
git merge --no-ff release/1.0.0
git branch -d release/1.0.0

合并工具和技巧

配置合并工具

# VS Code
git config --global merge.tool vscode
git config --global mergetool.vscode.cmd 'code --wait $MERGED'

# Vim
git config --global merge.tool vimdiff

# Beyond Compare
git config --global merge.tool bc3
git config --global mergetool.bc3.path "C:/Program Files/Beyond Compare 3/bcomp.exe"

# P4Merge
git config --global merge.tool p4merge
git config --global mergetool.p4merge.path "C:/Program Files/Perforce/p4merge.exe"

合并别名

# 设置有用的别名
git config --global alias.mg merge
git config --global alias.mgn "merge --no-ff"
git config --global alias.mgs "merge --squash"

# 查看合并历史的别名
git config --global alias.merges "log --merges --oneline"

# 撤销合并的别名
git config --global alias.unmerge "reset --hard HEAD~1"

自动化合并脚本

#!/bin/bash
# 安全合并脚本

merge_feature() {
    local feature_branch=$1
    local target_branch=${2:-main}
    
    if [ -z "$feature_branch" ]; then
        echo "用法: merge_feature <feature-branch> [target-branch]"
        return 1
    fi
    
    # 检查工作区状态
    if ! git diff-index --quiet HEAD --; then
        echo "错误: 工作区有未提交的更改"
        return 1
    fi
    
    # 更新目标分支
    git checkout $target_branch
    git pull origin $target_branch
    
    # 合并功能分支
    if git merge --no-ff $feature_branch; then
        echo "合并成功"
        
        # 询问是否删除分支
        read -p "是否删除功能分支 $feature_branch? (y/n): " -n 1 -r
        echo
        if [[ $REPLY =~ ^[Yy]$ ]]; then
            git branch -d $feature_branch
            git push origin --delete $feature_branch 2>/dev/null
        fi
    else
        echo "合并失败，请解决冲突后手动完成"
        return 1
    fi
}

# 使用方法
merge_feature feature/user-auth

故障排除

常见合并问题

# 问题1: 合并中断
# 查看状态
git status

# 继续合并
git merge --continue

# 取消合并
git merge --abort

# 问题2: 合并工具无法启动
# 检查配置
git config --get merge.tool

# 重新配置
git config --global merge.tool vimdiff

# 问题3: 二进制文件冲突
# 选择一个版本
git checkout --ours binary_file.jpg
git checkout --theirs binary_file.jpg
git add binary_file.jpg

合并性能优化

# 对于大型仓库，使用合并缓存
git config --global merge.renameLimit 999999

# 启用并行合并
git config --global merge.tool.trustExitCode true

# 优化合并算法
git config --global merge.algorithm patience

合并分析和报告

合并统计

# 查看合并统计
git log --merges --stat

# 查看合并趋势
git log --merges --since="1 month ago" --pretty=format:"%ad" --date=short | sort | uniq -c

# 分析合并冲突
git log --grep="conflict" --oneline

生成合并报告

#!/bin/bash
# 合并分析报告

echo "=== 合并分析报告 ==="
echo "生成时间: $(date)"
echo ""

echo "=== 合并统计 ==="
echo "总合并次数: $(git log --merges --oneline | wc -l)"
echo "最近30天合并: $(git log --merges --since='30 days ago' --oneline | wc -l)"
echo ""

echo "=== 最近的合并 ==="
git log --merges --oneline -10
echo ""

echo "=== 合并作者统计 ==="
git log --merges --pretty=format:"%an" | sort | uniq -c | sort -rn

总结

Git 合并的核心要点：

基本操作

git merge branch-name       # 基本合并
git merge --no-ff branch    # 非快进合并
git merge --squash branch   # 压缩合并
git merge --abort          # 取消合并

冲突处理

🔍 识别冲突文件和位置
✏️ 手动编辑或使用合并工具
✅ 标记冲突已解决并提交
🚫 必要时取消合并

最佳实践

✅ 合并前确保分支是最新的
✅ 选择合适的合并策略
✅ 编写清晰的合并信息
✅ 合并后及时清理分支

工作流选择

简单项目：直接合并
团队协作：Pull Request 流程
复杂项目：Git Flow 或 GitHub Flow

掌握合并操作后，你就能够：

🔄 安全地整合不同分支的更改
🛠️ 有效处理合并冲突
📈 维护清晰的项目历史
👥 支持团队协作开发

在下一章中，我们将学习 Git Flow 工作流程。

#Git Merge

#合并基础概念

#什么是合并？

#合并的类型

#基本合并操作

#准备演示环境

#快进合并

#禁用快进合并

#三方合并

#创建三方合并场景

#自定义合并提交信息

#合并策略

#递归策略 (Recursive)

#Octopus 策略

#Ours 策略

#Subtree 策略

#处理合并冲突

#识别冲突

#查看冲突状态

#冲突标记解释

#手动解决冲突

#使用合并工具

#冲突解决策略

#高级合并操作

#压缩合并 (Squash Merge)

#部分合并

#合并特定提交范围

#撤销合并

#撤销未推送的合并

#撤销已推送的合并

#查找合并提交

#合并最佳实践

#1. 合并前的准备

#2. 选择合适的合并策略

#3. 编写清晰的合并信息

#4. 合并后的清理

#合并工作流

#GitHub Flow

#Git Flow

#合并工具和技巧

#配置合并工具

#合并别名

#自动化合并脚本

#故障排除

#常见合并问题

#合并性能优化

#合并分析和报告

#合并统计

#生成合并报告

#总结

#基本操作

#冲突处理

#最佳实践

#工作流选择