Git 拉取失败解决指南

问题描述

当从 Gogs 拉取代码时，可能会遇到以下错误：

error: Your local changes to the following files would be overwritten by merge:
    <file-name>
Please commit your changes or stash them before you merge.
###
修改尚未加入提交

原因

该错误发生的原因是：

• 本地工作目录有未提交的修改或未追踪的文件，Git 无法将远程仓库的更改合并到本地。
• 为了保护本地更改，Git 会阻止拉取操作，避免丢失本地修改。
• Rundeck job 执行到一半被kill，生成了缓存文件，导致和线上仓库不一致，判定本地目录为‘脏’。

解决方案

1. 查看本地修改

首先，可以检查哪些文件存在未提交的修改：

git status

2. 清理本地修改

如果不需要保留本地修改，可以强制清理本地工作目录：

# 放弃所有本地修改
git reset --hard

# 删除未追踪的文件
git clean -fd

3. 提交本地修改

如果需要保留本地更改，可以将其提交或暂存：

# 提交本地修改
git add .
git commit -m "Save local changes"

# 或者暂存修改
git stash

4. 拉取最新代码

清理或提交本地修改后，拉取最新的远程代码：

git pull origin <branch-name>

5. 解决冲突（如有）

如果本地和远程代码冲突，Git 会提示冲突文件，需要手动解决冲突并提交更改。

总结

• 如果本地有未提交的修改，Git 会阻止拉取，保护本地更改。
• 可以通过提交、清理或暂存修改来解决此问题。
• 保持工作目录干净，可以避免不必要的冲突和拉取失败。