解决 Git 冲突
识别、解决并从合并和变基冲突中恢复。
适用场景
git merge或git rebase报告冲突git cherry-pick无法干净应用git pull导致更改冲突git stash pop与当前工作区冲突
输入
- 必需:存在活跃冲突的仓库
- 可选:首选解决策略(ours、theirs、手动)
- 可选:关于哪些更改应优先的上下文信息
步骤
第 1 步:识别冲突来源
确定引起冲突的操作:
# Check current status
git status
# Look for indicators:
# "You have unmerged paths" — merge conflict
# "rebase in progress" — rebase conflict
# "cherry-pick in progress" — cherry-pick conflict
状态输出会告知哪些文件存在冲突以及当前进行中的操作。
预期结果: git status 显示列在"Unmerged paths"下的文件,并指示当前活跃的操作。
失败处理: 若 git status 显示工作区干净但预期存在冲突,则操作可能已完成或已中止。检查 git log 查看近期活动。
第 2 步:读取冲突标记
打开每个冲突文件,定位冲突标记:
<<<<<<< HEAD
// Your current branch's version
const result = calculateWeightedMean(data, weights);
=======
// Incoming branch's version
const result = computeWeightedAverage(data, weights);
>>>>>>> feature/rename-functions
<<<<<<< HEAD到=======:当前分支的版本(或正在变基到的分支)=======到>>>>>>>:传入的更改(被合并的分支或正在应用的提交)
预期结果: 每个冲突文件包含一个或多个带有 <<<<<<<、======= 和 >>>>>>> 标记的块。
失败处理: 若未找到标记但文件显示为冲突,可能是二进制文件冲突或"已删除 vs 已修改"冲突。使用 git diff --name-only --diff-filter=U 查看完整冲突列表。
第 3 步:选择解决策略
手动合并(最常用):编辑文件以逻辑方式合并两侧更改,然后删除所有冲突标记。
采用我方(保留当前分支版本):
# For a single file
git checkout --ours path/to/file.R
git add path/to/file.R
# For all conflicts
git checkout --ours .
git add -A
采用对方(保留传入分支版本):
# For a single file
git checkout --theirs path/to/file.R
git add path/to/file.R
# For all conflicts
git checkout --theirs .
git add -A
预期结果: 解决后,文件包含正确的合并内容,不残留任何冲突标记。
失败处理: 若选择了错误的一侧,可从合并基础重新读取冲突版本。在合并过程中,git checkout -m path/to/file 会重新创建冲突标记,让你重新尝试。
第 4 步:将文件标记为已解决
编辑完每个冲突文件后:
# Stage the resolved file
git add path/to/resolved-file.R
# Check remaining conflicts
git status
对"Unmerged paths"下列出的每个文件重复此操作。
预期结果: 所有文件从"Unmerged paths"移动到"Changes to be committed",任何文件中均不残留冲突标记。
失败处理: 若 git add 失败或标记仍然存在,请重新打开文件,确保所有 <<<<<<<、======= 和 >>>>>>> 行已被删除。
第 5 步:继续操作
所有冲突解决后:
合并操作:
git commit
# Git auto-populates the merge commit message
变基操作:
git rebase --continue
# May encounter more conflicts on subsequent commits — repeat steps 2-4
cherry-pick 操作:
git cherry-pick --continue
stash pop 操作:
# Stash pop conflicts don't need a continue — just commit or reset
git add .
git commit -m "Apply stashed changes with conflict resolution"
预期结果: 操作完成,git status 显示干净的工作区(或在 rebase 过程中移至下一个提交)。
失败处理: 若 continue 命令失败,检查 git status 查看剩余未解决的文件。所有冲突必须解决后才能继续。
第 6 步:必要时中止操作
若解决过于复杂或选择了错误的方法,可安全中止:
# Abort merge
git merge --abort
# Abort rebase
git rebase --abort
# Abort cherry-pick
git cherry-pick --abort
预期结果: 仓库恢复到操作开始前的状态,无数据丢失。
失败处理: 若中止失败(罕见情况),使用 git reflog 找到操作前的提交,并通过 git reset --hard <commit> 恢复。谨慎使用——此操作会丢弃未提交的更改。
第 7 步:验证解决结果
操作完成后:
# Verify clean working tree
git status
# Check that the merge/rebase result is correct
git log --oneline -5
git diff HEAD~1
# Run tests to confirm nothing is broken
# (language-specific: devtools::test(), npm test, cargo test, etc.)
预期结果: 工作区干净,合并历史正确,测试通过。
失败处理: 若解决后测试失败,合并可能引入了逻辑错误,即使语法冲突已解决。请仔细审查差异并修复。
验证清单
- 所有文件中均不残留冲突标记(
<<<<<<<、=======、>>>>>>>) -
git status显示干净的工作区 -
git log中的合并/变基历史正确 - 冲突解决后测试通过
- 未引入意外的更改
常见问题
- 盲目采用一侧:
--ours或--theirs会完全丢弃另一侧。仅在确定某个版本完全正确时使用。 - 代码中残留冲突标记:编辑后始终搜索整个文件中的残留标记。部分解决会导致代码损坏。
- 变基过程中修改提交:在交互式变基过程中,除非变基步骤明确要求,否则不要使用
--amend。改用git rebase --continue。 - 中止时丢失工作:
git rebase --abort和git merge --abort会丢弃所有解决工作。仅在想重新开始时才中止。 - 解决后不运行测试:语法上干净的合并仍可能在逻辑上有误。始终运行测试。
- 变基后强制推送:变基共享分支后,强制推送前请与协作者沟通,因为这会重写历史。
相关技能
commit-changes— 冲突解决后的提交manage-git-branches— 导致冲突的分支工作流configure-git-repository— 仓库设置与合并策略