处理推送冲突

推送冲突的产生原因

推送冲突通常发生在多人协作开发时，多个开发者同时修改了同一个文件的相同部分。Git无法自动合并这些修改，需要人工介入解决。常见场景包括：

1. 两个开发者同时修改了同一行代码
2. 一个开发者删除了文件，而另一个开发者修改了该文件
3. 分支合并时出现不兼容的修改

// 开发者A修改了utils.js
function calculateTotal(items) {
  return items.reduce((sum, item) => sum + item.price, 0);
}

// 开发者B同时修改了同一函数
function calculateTotal(products) {
  let total = 0;
  products.forEach(product => {
    total += product.cost;
  });
  return total;
}

检测推送冲突

当尝试推送本地提交到远程仓库时，如果遇到冲突，Git会明确提示：

! [rejected]        main -> main (non-fast-forward)
error: failed to push some refs to 'github.com:user/repo.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.

此时需要先拉取远程更改，Git会标记出冲突文件：

CONFLICT (content): Merge conflict in src/utils.js
Automatic merge failed; fix conflicts and then commit the result.

解决推送冲突的基本步骤

1. 拉取远程最新更改：

   git pull origin main
   

2. 打开冲突文件，Git会用特殊标记显示冲突内容：

   <<<<<<< HEAD
   function calculateTotal(items) {
     return items.reduce((sum, item) => sum + item.price, 0);
   }
   =======
   function calculateTotal(products) {
     let total = 0;
     products.forEach(product => {
       total += product.cost;
     });
     return total;
   }
   >>>>>>> abc1234
   

3. 手动编辑文件，解决冲突。可以：

   • 保留其中一个版本
   • 合并两个版本的修改
   • 完全重写该部分代码

4. 添加解决后的文件并提交：

   git add src/utils.js
   git commit -m "Resolve merge conflict in utils.js"
   

5. 完成推送：

   git push origin main
   

高级冲突解决策略

使用合并工具

配置图形化合并工具可以更直观地解决冲突：

git config --global merge.tool vscode
git config --global mergetool.vscode.cmd "code --wait $MERGED"

然后运行：

git mergetool

重置分支

如果冲突复杂，可以重置到合并前状态重新尝试：

git merge --abort
# 或
git reset --hard HEAD

使用rebase替代merge

变基可以保持提交历史的线性：

git pull --rebase origin main

遇到冲突时：

1. 解决冲突
2. git add 冲突文件
3. git rebase --continue

创建临时分支

对于复杂冲突，可以创建临时分支来测试解决方案：

git checkout -b temp-conflict-resolution
# 解决冲突后
git checkout main
git merge temp-conflict-resolution

预防推送冲突的最佳实践

1. 频繁拉取变更：

   git fetch origin
   git rebase origin/main
   

2. 小步提交：保持每个提交的改动范围小且专注

3. 沟通协作：团队成员间及时沟通正在修改的文件

4. 分支策略：

   # 为新功能创建独立分支
   git checkout -b feature/new-payment
   

5. 预检脚本：在提交前运行测试

   // package.json
   {
     "scripts": {
       "prepush": "npm test && npm run lint"
     }
   }
   

处理特定类型的冲突

二进制文件冲突

对于图片、PDF等二进制文件，通常需要选择保留哪个版本：

git checkout --ours image.png  # 保留本地版本
git checkout --theirs image.png  # 保留远程版本
git add image.png

删除/修改冲突

当一个开发者删除文件而另一个修改时：

# 如果要保留修改
git add deleted-file.js
# 如果要接受删除
git rm deleted-file.js

行尾符冲突

跨平台开发时可能出现：

git config --global core.autocrlf true  # Windows
git config --global core.autocrlf input # Linux/Mac

自动化冲突解决

对于可预测的冲突，可以设置.gitattributes文件指定合并策略：

package-lock.json merge=ours
*.min.js merge=ours

或创建自定义合并驱动程序：

git config --global merge.ours.driver true

团队协作中的冲突管理

1. 代码所有者：使用CODEOWNERS文件指定特定文件的负责人

   src/utils.js @team/core @user1
   

2. 保护分支：配置分支保护规则，要求PR通过后才能合并

3. 代码审查：通过Pull Request流程减少冲突

// 示例：添加清晰的代码注释减少理解冲突
/**
 * 计算商品总价
 * @param {Array} items - 商品数组，需包含price属性
 * @returns {number} 总价格
 */
function calculateTotal(items) {
  // 使用reduce更简洁
  return items.reduce((sum, item) => sum + item.price, 0);
}

复杂场景下的冲突解决

长期分支的冲突

当特性分支与主分支差异较大时：

git checkout feature
git merge main  # 定期合并主分支变更
# 解决所有冲突后
git push origin feature

历史重写后的冲突

修改已推送的提交历史后：

git push --force-with-lease origin main

子模块冲突

当子模块引用发生冲突时：

git submodule update --init --recursive
cd submodule
git checkout commit-hash
cd ..
git add submodule