克隆Git仓库时遇「未跟踪工作树文件将被合并覆盖」错误求助

开发者阿泽

2026-5-25

解决Git克隆时"Untracked working tree file would be overwritten by merge"问题

我来帮你搞定这个棘手的Git问题，这种情况我在团队协作里碰到过好多次，大概率是本地残留缓存、Git配置或者克隆过程中的隐性干扰导致的，试试下面这些一步步的解决方案：

彻底清理本地Git残留
有时候单纯删除目录可能留了隐藏的缓存文件，先确保你不在任何Git仓库目录下，执行这个命令清理全局未跟踪文件和缓存：
```
git clean -fdx
```
这里-f强制删除，-d删除未跟踪目录，-x连.gitignore里的文件也一起清，确保本地没有任何遗留的Git相关文件。
用全新目录重新克隆
别用之前的src目录名，换个新名字比如src-fresh来克隆，彻底避开旧目录可能存在的隐藏残留：
```
git clone git@github.com:myrepo/src.git src-fresh
```
检查并调整Git全局配置
跨平台协作时，换行符或文件权限配置经常会导致文件被误标记为修改。先看看你的全局配置：
```
git config --global --list
```
如果看到core.autocrlf=true，改成false试试（避免换行符自动转换导致的文件变更）：
```
git config --global core.autocrlf false
```
另外，关闭文件权限检测（防止Linux和Windows之间的权限差异导致修改标记）：
```
git config --global core.filemode false
```
改完配置后再重新克隆。
克隆后立即校验状态
克隆完成后马上进入新目录检查状态：
```
cd src-fresh
git status
```
如果这时候就显示有修改，那基本就是配置的问题，调整好配置重新克隆就能解决。
极端情况：强制重置仓库状态
如果以上步骤都没用，克隆后执行强制重置和清理，把本地状态完全同步到远程仓库：
```
git reset --hard HEAD
git clean -fd
```
这个命令会丢弃所有本地修改和未跟踪文件，完全回到远程仓库的最新状态。