执行git reset --hard后git pull仍提示本地变更被覆盖如何解决

问题产生原因 #

• 文件被设置了assume-unchanged或skip-worktree标记：这类标记的作用是让Git暂时忽略文件的本地改动，git reset --hard不会重置这类标记的文件，因此你在状态列表里看不到未提交改动，但合并时Git检测到远程文件和本地文件存在差异，就会触发覆盖报错。
• 行尾换行符自动转换配置冲突：如果开启了core.autocrlf自动转换换行符，本地文件经过转换后的实际内容和远程文件存在字节差异，但Git不会将这类差异展示为未提交改动，合并时就会判定为存在冲突。
• 文件名大小写不敏感冲突：Windows、macOS默认使用大小写不敏感的文件系统，如果远程仓库存在大小写不同的同名文件（比如file.txt和File.txt），或者远程文件名大小写和本地不一致，git reset --hard无法正确覆盖文件，就会持续报错。
• 本地存在未追踪的同名文件：如果本地的file.txt没有被Git纳入追踪（比如被加入了.gitignore），git reset --hard不会处理这类文件，合并时远程的file.txt需要覆盖本地未追踪文件，就会触发报错。

排查修复步骤 #

1. 排查文件特殊标记
   执行以下命令查看文件标记状态：

git ls-files -v file.txt

如果输出行首为小写h，说明被设置了assume-unchanged，执行以下命令解除：

git update-index --no-assume-unchanged file.txt

如果输出行首为小写S，说明被设置了skip-worktree，执行以下命令解除：

git update-index --no-skip-worktree file.txt

解除标记后再次执行git reset --hard，再尝试pull即可。

2. 排查换行符配置问题
   先查看当前换行符转换配置：

git config core.autocrlf

如果返回值为true或input，临时关闭转换规则：

git config core.autocrlf false

执行git reset --hard后再尝试pull。问题解决后可通过项目根目录新增.gitattributes文件统一配置行尾规则，避免后续同类问题。

3. 排查文件名大小写问题
   执行以下命令查看远程分支上的同名文件大小写，注意替换为你当前使用的分支名：

git ls-tree --name-only origin/当前分支名 | grep -i file.txt

如果返回多个大小写不同的同名文件，或者和本地文件名大小写不一致，直接手动删除本地的file.txt，再执行pull拉取远程文件即可。后续可开启Git大小写敏感配置避免重复踩坑：

git config core.ignorecase false

4. 排查未追踪文件问题
   执行以下命令查看文件状态：

git status --ignored=traditional

如果file.txt出现在未追踪文件或忽略文件列表中，手动删除本地的file.txt后再执行pull即可。

内容的提问来源于stack exchange，提问作者Hu1buerger