简介
Git 是一个功能强大的版本控制系统，能够帮助开发者高效地管理代码并进行协作。然而，你有时可能会遇到一些令人困惑的错误信息，尤其是当你刚接触 Git 时。一个常见的错误是「Your local changes would be overwritten by merge」（你的本地更改将被合并操作覆盖）。当 Git 无法安全地执行合并（因为这会覆盖你尚未提交的本地修改）时，就会出现此错误。
在本实验中，你将了解导致此错误的原因、如何解决它，以及如何在未来的 Git 工作流中实施预防策略。
理解 Git 工作流
在这一步中，你将回顾基本的 Git 工作流，并检查为演示该错误而准备的仓库。
什么是 Git
Git 是一个分布式版本控制系统，允许多个开发者在同一个代码库上工作，而不会相互干扰。它会跟踪文件随时间的变化，让你在需要时可以回退到之前的版本。
基本 Git 工作流
典型的 Git 工作流包含以下步骤：
- 在工作目录中修改文件
- 使用
git add暂存更改 - 使用
git commit提交更改 - 使用
git push将更改推送到远程仓库 - 使用
git pull从远程仓库拉取更改
开始实验
首先，进入我们的项目目录：
cd /home/labex/project/git-merge-demo
检查仓库的状态：
git status
你应该会看到类似以下的输出：
On branch main
nothing to commit, working tree clean
现在，查看我们拥有的分支：
git branch
你应该会看到：
development
* main
星号（*）表示你当前位于 main 分支。让我们检查仓库中的文件：
ls -la
你应该会看到：
total 20
drwxr-xr-x 3 labex labex 4096 ... .
drwxr-xr-x 3 labex labex 4096 ... ..
drwxr-xr-x 8 labex labex 4096 ... .git
-rw-r--r-- 1 labex labex 24 ... README.md
-rw-r--r-- 1 labex labex 27 ... script.js
-rw-r--r-- 1 labex labex 25 ... styles.css
查看这些文件的内容：
cat README.md
cat script.js
cat styles.css
很好！现在你已经了解了仓库的结构。在下一步中，我们将创建一个会导致「local changes would be overwritten by merge」错误的场景。
创建合并冲突场景
在这一步中，我们将创建一个导致「Your local changes would be overwritten by merge」错误的场景。这将帮助你理解该错误产生的原因。
在 development 分支上进行更改
首先，切换到 development 分支并进行一些更改：
git checkout development
你应该会看到：
Switched to branch 'development'
现在，修改 script.js 文件：
echo "console.log('Hello from development branch!');" > script.js
提交此更改：
git add script.js
git commit -m "Update script.js on development branch"
你应该会看到：
[development xxxxxxx] Update script.js on development branch
1 file changed, 1 insertion(+), 1 deletion(-)
在 main 分支上进行未提交的更改
现在，切回 main 分支：
git checkout main
验证我们是否在 main 分支上：
git branch
你应该会看到：
development
* main
现在，在 main 分支上修改同一个文件（script.js），但这次我们不提交更改：
echo "console.log('Hello from main branch!');" > script.js
触发合并冲突错误
现在我们的工作目录中有未提交的更改，尝试将 development 分支合并到 main 分支：
git merge development
你应该会看到类似以下的错误信息：
error: Your local changes to the following files would be overwritten by merge:
script.js
Please commit your changes or stash them before you merge.
Aborting
恭喜！你已经成功创建了一个会触发「Your local changes would be overwritten by merge」错误的场景。
该错误发生的原因是：
- 你在
development分支上修改了script.js并提交了更改。 - 你也在
main分支上修改了script.js，但没有提交更改。 - 当尝试合并时，Git 检测到你的未提交更改会被合并操作覆盖。
在下一步中，我们将学习如何解决此错误。
使用 Git Stash 解决合并冲突
在这一步中，你将使用 git stash 解决「Your local changes would be overwritten by merge」错误。该命令会暂时保存你的未提交更改，以便稍后应用。
什么是 Git Stash
git stash 是一个 Git 命令，它会将你的未提交更改（包括已暂存和未暂存的）保存起来以备后用，然后将工作副本恢复到干净的状态。
使用 Git Stash 解决错误
使用 git stash 保存我们的未提交更改：
git stash
你应该会看到类似以下的输出：
Saved working directory and index state WIP on main: xxxxxxx Initial commit
此消息确认你的更改已保存。验证工作目录现在是否干净：
git status
你应该会看到：
On branch main
nothing to commit, working tree clean
现在检查 script.js 的内容：
cat script.js
你应该会看到原始内容：
console.log('Hello, Git!');
合并 development 分支
现在工作目录已清理干净，我们可以安全地合并 development 分支：
git merge development
你应该会看到：
Updating xxxxxxx..xxxxxxx
Fast-forward
script.js | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
再次检查 script.js 的内容：
cat script.js
现在你应该会看到：
console.log('Hello from development branch!');
恢复已暂存的更改
现在我们已经成功合并了 development 分支，让我们恢复之前暂存的更改：
git stash list
你应该会看到：
stash@{0}: WIP on main: xxxxxxx Initial commit
这表明我们有一个已保存的 stash。应用它：
git stash apply
你可能会看到冲突消息：
Auto-merging script.js
CONFLICT (content): Merge conflict in script.js
这是正常的，因为 Git 正在尝试将你暂存的更改应用到合并后的文件之上。检查 script.js 的内容：
cat script.js
你应该会看到类似以下内容：
<<<<<<< Updated upstream
console.log('Hello from development branch!');
=======
console.log('Hello from main branch!');
>>>>>>> Stashed changes
这是一个需要手动解决的合并冲突。使用 nano 打开文件：
nano script.js
编辑文件以保留两个更改或选择其中一个：
// 保留两个更改
console.log("Hello from development branch!");
console.log("Hello from main branch!");
按 Ctrl+O 保存文件，按 Enter 确认，然后按 Ctrl+X 退出 nano。
现在，暂存并提交已解决的冲突：
git add script.js
git commit -m "Merge development branch and resolve conflict"
恭喜！你已经成功使用 git stash 解决了「Your local changes would be overwritten by merge」错误。
解决合并错误的其他方法
在上一节中，我们使用了 git stash 来解决错误。在这一步中，我们将探索处理这种情况的其他方法。
方法 1：在合并前提交更改
避免该错误最简单的方法之一就是在执行合并操作之前提交你的更改。
让我们创建另一个场景来演示这一点。首先，修改 styles.css 文件：
echo "body { background-color: #f0f0f0; }" > styles.css
现在，我们不暂存更改，而是提交它们：
git add styles.css
git commit -m "Update styles.css on main branch"
你应该会看到：
[main xxxxxxx] Update styles.css on main branch
1 file changed, 1 insertion(+), 1 deletion(-)
现在，切换到 development 分支，对同一个文件进行更改并提交：
git checkout development
echo "body { background-color: #e0e0e0; }" > styles.css
git add styles.css
git commit -m "Update styles.css on development branch"
现在，切回 main 分支：
git checkout main
如果我们现在尝试合并，就不会出现「local changes would be overwritten」错误，因为我们已经提交了更改。但是，我们可能会遇到合并冲突：
git merge development
你可能会看到：
Auto-merging styles.css
CONFLICT (content): Merge conflict in styles.css
Automatic merge failed; fix conflicts and then commit the result.
这是另一种冲突，当两个分支都对文件的同一部分进行了提交更改时会发生。解决此冲突：
cat styles.css
你应该会看到：
<<<<<<< HEAD
body { background-color: #f0f0f0; }
=======
body { background-color: #e0e0e0; }
>>>>>>> development
编辑文件以解决冲突：
nano styles.css
将内容更改为：
body {
background-color: #f5f5f5;
}
保存文件并提交已解决的冲突：
git add styles.css
git commit -m "Resolve merge conflict in styles.css"
方法 2：使用 Git Checkout 丢弃本地更改
另一种方法是，如果你不再需要本地更改，可以直接丢弃它们：
## 对 README.md 进行更改
echo "## Updated README" > README.md
## 检查状态
git status
你应该会看到：
On branch main
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)
modified: README.md
no changes added to commit (use "git add" and/or "git commit -a")
如果你决定不需要这些更改，可以丢弃它们：
git checkout -- README.md
再次检查状态：
git status
你应该会看到：
On branch main
nothing to commit, working tree clean
README.md 的内容已恢复到原始状态：
cat README.md
这些替代方法根据你的具体情况和需求，为你处理该错误提供了不同的选择。
防止合并冲突的最佳实践
在这一步中，你将练习一些有助于防止「Your local changes would be overwritten by merge」错误的习惯。
1. 频繁提交更改
进行小而频繁的提交有助于减少合并冲突的机会：
## 进行小幅更改
echo "// Add a comment" >> script.js
## 提交更改
git add script.js
git commit -m "Add a comment to script.js"
2. 推送前先拉取
在推送更改之前，务必从远程仓库拉取更改：
## 在实际场景中，你会执行：
## git pull origin main
## 由于我们在本地工作，通过切换分支来模拟此操作
git checkout development
git checkout main
3. 使用功能分支
为每个功能或错误修复创建一个新分支：
## 创建一个新的功能分支
git checkout -b feature-navbar
## 进行一些更改
echo "/* Navigation bar styles */" >> styles.css
## 提交更改
git add styles.css
git commit -m "Add navigation bar styles"
回到 main 分支：
git checkout main
4. 定期与 main 分支合并或变基
保持你的功能分支与 main 分支同步：
## 切换到功能分支
git checkout feature-navbar
## 在实际场景中，你会与 main 合并或变基：
## git merge main
## 或
## git rebase main
## 在演示中，我们模拟此操作
echo "/* More styles */" >> styles.css
git add styles.css
git commit -m "Add more styles"
## 回到 main
git checkout main
5. 频繁使用 Git Status
在执行合并或拉取等操作之前，务必检查仓库的状态：
git status
你应该会看到：
On branch main
nothing to commit, working tree clean
6. 与团队沟通
虽然我们无法在实验中演示这一点，但沟通是避免冲突的关键。确保你的团队知道你正在处理哪些文件，以避免同时修改相同的文件。
7. 对复杂的合并使用 GUI 工具
对于复杂的合并冲突，考虑使用 GUI 工具：
## 列出可用的 GUI 合并工具（在实际环境中）
## git mergetool --tool-help
## 在本例中，仅显示通常可用的合并工具
echo "Common merge tools: meld, kdiff3, vimdiff, vscode"
通过遵循这些最佳实践，你可以显著减少 Git 工作流中合并冲突以及「Your local changes would be overwritten by merge」错误的发生。
总结
在本实验中，你学习了如何解决 Git 中的「Your local changes would be overwritten by merge」错误。这是一个常见问题，通常发生在工作目录中有未提交的修改时尝试合并或拉取更改。
本实验涵盖的关键点：
你通过在不同分支上对同一个文件进行更改，创建了一个触发该错误的场景。
你学习了多种解决此错误的方法：
- 使用
git stash暂时保存更改 - 在合并前提交更改
- 使用
git checkout丢弃不需要的本地更改
- 使用
你探索了防止合并冲突的最佳实践：
- 进行频繁、小幅的提交
- 推送前先拉取
- 使用功能分支
- 定期与 main 分支合并或变基
- 频繁使用
git status - 与团队沟通
- 对复杂的合并使用 GUI 工具
通过理解这些概念和技术，你可以更高效地管理 Git 工作流，并避免导致合并冲突的常见陷阱。
请记住，Git 是一个强大的版本控制和协作工具，但它需要仔细管理更改以避免冲突。你在本实验中学到的技能将帮助你在与他人有效协作的同时，保持代码库的完整性。
