Git 分支merge合并常用步骤与命令操作

( Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu )
（注：文章采用豆包AI做输出材料整理）

使用git做代码的管理，对于开发人员来说，时常要做的就是代码分支的合并。
如何来做代码分支的合并呢，如何能够较少的出差错来做代码分支的merge合并。

对于向master分支合并的过程，个人感觉的话，采用如下的策略步骤：

1. 提前清理环境，保证待合并分支目录干净：切master→拉远端最新→stash清脏区→校验干净。
2. 选择合并操作：预览分支差异→按需 普通合并 或 squash 合并。
3. 解决合并冲突：冲突合并策略三选一，之后解决冲突→自查代码 + 编译跑通。
4. 提交但不push远端，检查合并内容：本地 commit→看分支树 + 差异核验。
5. 合并内容检查测试通过，Push远端：dry-run 模拟推送→确认后真实 push。
6. 合并内容异常，回退重新合并：本地未 push 直接 reset 回退；清临时缓存之后再重新走合并。

第一步：清理环境，确保master 干净

目标：合并前必须让本地master分支无未提交修改、无冲突文件。

# 1. 切换到主分支 mastergitcheckout master# 2. 拉取远端最新代码（避免本地过时）gitpull origin master# 3. 清理未提交的修改（暂存/丢弃二选一）# 方案A：暂存修改（后续还能用）⭐推荐gitstash# 方案B：直接丢弃所有未提交修改（谨慎使用）# git reset --hard && git clean -fd# 4. 验证环境是否干净（输出 nothing to commit 即成功）gitstatus

第二步：执行合并（二选一：区别是，保留还是压缩提交历史）

选项1：保留完整提交历史（默认，通常推荐保留子提交历史）

直接合并，分支所有提交记录都会保留：

# 合并你的分支到 mastergitmerge branch1

选项2：压缩提交历史（Squash，干净整洁）

把分支上所有提交打包成 1 个新提交，看不到原始提交记录：

gitmerge--squashbranch1

执行后会自动暂存所有变更，需要手动 commit。

第三步：解决合并冲突（3 种方案）

如果合并时报Automatic merge failed; fix conflicts and then commit the result.，就是有冲突。

冲突处理方案

1. 使用 master 版本（保留主分支代码）
   丢弃分支的修改，完全用 master 原有代码
2. 使用分支版本（保留开发分支代码）
   丢弃 master 的修改，完全用分支代码
3. 手动修改代码 → 标记为已解决（最常用）
   手动编辑冲突文件，删除<<<<<<</=======/>>>>>>>标记

命令行快速解决冲突

# 查看哪些文件冲突gitstatus# 方案1：指定文件使用 master 版本gitcheckout--ours冲突文件路径# 方案2：指定文件使用分支版本gitcheckout--theirs冲突文件路径# 方案3：手动修改后，标记冲突已解决gitadd冲突文件路径# 所有冲突解决后gitcommit

第四步：本地提交，检查合并结果（不 Push）

1. 完成合并/解决冲突后，执行提交：

# squash 合并必须手动 commit；普通合并可直接commitgitcommit-m"合并分支：branch1"

2. 检查分支树和修改记录

# 图形化查看分支合并记录 ⭐gitlog--graph--oneline--all

• Differ with parent1：你合并分支（branch1）的修改
• Differ with parent2：主分支 master 的修改
  核对修改内容，确认无误再推送。

第五步：推送远端 / 合并失败回退

1. 确认无误，推送到服务器

gitpush origin master

2. 合并出错，回退重来

如果合并后发现错误，恢复到合并前的干净 master：

# 查看合并前的 commit IDgitreflog# 回退到合并前的版本（替换为你的commit ID）gitreset--hard合并前的commitID# 清理残留文件gitclean-fd# 恢复后重新拉取最新代码gitpull origin master

回退后回到第一步，发起重新合并。

完整极简命令速查表

# 1. 清理环境gitcheckout mastergitpullgitstashgitstatus# 2. 合并（二选一）gitmerge 分支名# 保留历史gitmerge--squash分支名# 压缩历史# 3. 解决冲突 → git add → git commit# 4. 检查gitlog--graph# 5. 推送/回退gitpush# 出错回退：git reset --hard 版本号

总结

1. 合并核心：先清环境、再合并、解冲突、本地检查，提交但不推送，** 核查提交文件，检查通过再推送**。
2. 历史选择：大多情况用普通合并，特别是协作开发，精简提交历史时采用squash合并
3. 安全兜底：推送前，合并出错用git reset --hard回退，之后重新发起合并。推送后，对于团队工作方式，再发现出错大多采用新提交修复方式，一般不覆盖推送。

( Owed by: 春夜喜雨 http://blog.csdn.net/chunyexiyu )