作者：阿柴
标签：Git 版本控制 VS Code 开发效率 协作开发

---

引言

在团队协作或个人开发中，你是否遇到过这样的场景？

bash

git push -u origin master
! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'https://github.com/xxx/xxx.git'

或者：

bash

git pull --rebase origin master
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Could not apply 4e8ff4b... feat: 更新项目文档

别担心，这不是你的代码出了问题，而是 Git 在提醒你：“远程和本地的提交历史分叉了，需要你手动决定如何合并。”

本文将带你一步步理解冲突本质、手动解决冲突，并利用 VS Code 的图形化功能高效处理，让你从“Git 恐慌”走向“Git 自如”。

---

一、为什么会发生合并冲突？

Git 的合并冲突通常发生在以下情况：

1. 你在本地提交了代码（如 README.md）。
2. 同时，远程仓库也被更新了（如 GitHub 上创建仓库时添加了默认的 README.md 或 .gitignore）。
3. 当你执行 git pull 或 git pull --rebase 时，Git 发现同一文件的同一部分被两个不同的提交修改了，无法自动决定“听谁的”，于是暂停操作，等待你手动解决。

💡 简单说：“你们俩改了同一个地方，但改得不一样，我没法猜，你说听谁的？”

---

二、解决步骤：从命令行到图形化

步骤 1：拉取远程更改（使用 rebase）

bash

git pull --rebase origin master

• --rebase 的作用是将你的本地提交“变基”到远程最新提交之上，保持提交历史线性，避免产生多余的合并提交。
• 如果出现冲突，Git 会提示你哪些文件冲突了。

---

步骤 2：查看冲突文件

运行：

bash

git status

你会看到类似：

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   README.md

这说明 README.md 文件存在冲突。

---

步骤 3：打开冲突文件，识别冲突区域

用编辑器打开 README.md，你会看到：

markdown

<<<<<<< HEAD
# Remote README
This is the default README from GitHub.
=======
# Local README
This is my professional project documentation.
>>>>>>> 4e8ff4b... feat: 更新项目文档

冲突标记解析：

标记	含义
<<<<<<< HEAD	远程仓库的最新内容（绿色区域）
=======	分隔符
>>>>>>> 4e8ff4b...	你本地的修改内容（紫色区域）

---

步骤 4：解决冲突（两种方式）

方式一：手动编辑（适合简单合并）

1. 删除所有冲突标记（<<<<<<<、=======、>>>>>>>）。
2. 保留你想要的内容。例如，你想保留本地的专业文档：

markdown

# Local README
This is my professional project documentation.

方式二：使用 VS Code 图形化按钮（推荐！）

VS Code 提供了超便捷的图形化操作：

1. 打开冲突文件。
2. 在冲突区域上方，你会看到三个按钮：
   • 🟢 Accept Current Change → 保留你本地的修改
   • 🔵 Accept Incoming Change → 保留远程的修改
   • 🟡 Accept Both Changes → 同时保留两部分（注意顺序）

推荐操作：点击 🟢 Accept Current Change，保留你的本地专业文档。

---

步骤 5：标记冲突已解决并继续

bash

# 添加已解决的文件
git add README.md

# 继续 rebase 过程
git rebase --continue

Git 会完成剩余的变基操作。

---

步骤 6：推送代码

bash

git push -u origin master

搞定！你的代码已成功推送到远程仓库。

---

三、最佳实践建议

1. 推送前先拉取：

   bash

   git pull --rebase origin master

   养成习惯，避免冲突。

2. 使用 --rebase 而不是默认 merge：

   • 保持历史线性，更清晰。
   • 避免产生无意义的“合并提交”。

3. 善用 VS Code 的合并功能：

   • 快速选择保留哪部分。
   • 减少手动编辑错误。

4. 提交信息要清晰：

   • 使用 feat:, fix:, docs: 等前缀，便于团队协作。

---

四、错误操作警示

• git rebase --skip：跳过你的提交，可能导致代码丢失。
• git rebase --abort：放弃整个 rebase，回到之前状态（可用于“后悔”）。
• 直接强制推送（git push --force）：可能覆盖他人代码，仅在个人项目且确定安全时使用。

---

结语

Git 的合并冲突并不可怕，它其实是版本控制系统在保护你的代码安全。通过理解其原理，并结合 VS Code 的图形化工具，你可以高效、优雅地解决冲突，甚至把它变成一次“代码整合”的机会。

记住：每一次冲突的解决，都是你 Git 技能的一次升级。

---

💬 欢迎在评论区分享你的 Git 冲突解决经验！

---

作者：阿柴
日期：2025年9月16日
版权声明：本文首发于个人博客，转载请注明出处。