Git单仓库内部分文件始终处于未暂存状态如何排查解决

• 换行符配置冲突：Windows与类Unix系统换行符规则不匹配，core.autocrlf配置和仓库文件实际换行符不符时，Git会反复识别到文件"被修改"，实际无实质内容变更
• 文件权限位异常：类Unix系统下文件可执行权限变更会被Git追踪，WSL挂载宿主机目录、云同步盘同步仓库时，权限位会被自动篡改，每次操作后都会被标记为未暂存
• .gitignore规则失效：文件已经被历史提交纳入Git追踪，后续添加的忽略规则不会对已追踪文件生效，文件会持续出现在变更列表
• Git子模块配置异常：子模块commit指针漂移、子模块目录被误修改时，会持续显示未暂存状态
• Git索引文件损坏：Git用于追踪文件状态的.git/index文件逻辑损坏，会导致状态识别错乱，这类问题通常仅出现在单个仓库
• 大小写文件名冲突：Windows/macOS默认文件系统大小写不敏感，仓库内如果存在仅大小写不同的同名文件，Git会持续识别到文件变更
• 第三方进程篡改文件：编辑器自动格式化、云同步盘实时同步、杀毒软件篡改文件属性，会导致stash、提交操作完成后文件立刻被改回异常状态

1. 先确认文件实际变更内容，不要直接依赖git status的输出，执行git diff查看具体差异：
   • 若diff内容全是^M标记、无可见文本差异，为换行符问题
   • 若diff仅显示old mode 100644 new mode 100755类权限字段，为文件权限问题
   • 若diff仅显示子模块目录的commit哈希变化，为子模块异常
2. 验证忽略规则有效性：执行git check-ignore -v <异常文件路径>，若无输出说明文件已被Git追踪，.gitignore规则不生效
3. 对比仓库本地与全局Git配置：执行git config --local --list查看仓库专属配置，重点核对core.autocrlf、core.filemode、core.ignorecase三个配置项，和git config --global --list的输出比对，确认是否存在仓库单独配置的异常值
4. 排查外部进程干扰：关闭所有编辑器、云同步客户端、杀毒软件后执行git status，等待1分钟后再次执行，若状态自动变化，说明存在后台进程篡改文件

小提示：如果执行git stash后立刻执行git status仍然显示未暂存文件，可直接排除文件内容本身的问题，优先排查配置、索引损坏、外部进程三类原因

• 换行符问题：团队统一换行符规则，Windows端执行git config --global core.autocrlf true，Mac/Linux端执行git config --global core.autocrlf input，仓库根目录添加.gitattributes文件强制指定换行符规则，之后执行以下命令重建索引：

  git rm --cached -r .
  git reset --hard
  

• 文件权限问题：如果不需要追踪文件权限变更，直接执行git config core.filemode false关闭权限识别；如果是WSL挂载目录问题，将仓库迁移到WSL原生文件系统目录下
• .gitignore失效问题：执行git rm --cached <需要忽略的文件路径>将文件从Git索引中移除，提交变更后后续忽略规则即可正常生效
• 子模块异常：执行git submodule update --init --recursive同步子模块到正确commit指针；如果不再需要对应子模块，执行git submodule deinit <子模块路径>移除即可
• 索引损坏问题：直接删除损坏的索引文件重建即可：

  rm -f .git/index
  git reset
  

• 文件名大小写冲突：执行git config core.ignorecase false开启Git大小写识别，删除仅大小写不同的冗余文件，提交变更后可根据系统习惯恢复对应配置
• 外部进程篡改问题：将仓库目录加入杀毒软件白名单，关闭编辑器的自动保存、自动格式化功能，不要将Git仓库放在OneDrive、iCloud、百度网盘等云同步目录中

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