GitHub显示重复文件但本地无差异,拉取主分支提示最新如何修复
问题核心成因
- 差异根源来自不同环境的文件系统大小写敏感性差异:GitHub后端运行在Linux类环境,原生大小写敏感,会将前缀相同仅大小写不同的文件识别为完全独立的两个文件;而Windows、macOS的默认文件系统为大小写不敏感模式,仅大小写不同的同前缀文件只会保留最后写入的那一个,本地无法感知另一个文件的存在。
- 拉取时提示「Already up to date」的原因:Git默认在Windows、macOS环境下会自动开启
core.ignorecase配置,将大小写不同的同前缀文件判定为同一个文件,当本地存在其中一个匹配版本的文件时,Git会直接认为本地版本已经和远程一致,不会触发另一个遗留文件的同步或删除提示。 - 你提到的GitHub上的小写命名旧文件,本质是历史提交时不同环境下产生的大小写差异遗留条目,并未被本地文件系统感知到,因此不会在本地出现重复展示。
分步修复操作
- 先强制Git开启大小写敏感校验,准确识别仓库内的重复文件
执行命令:git config core.ignorecase false
该配置会关闭Git默认的大小写忽略逻辑,不再将大小写不同的同前缀文件判定为同一文件。 - 枚举所有存在大小写重复的文件列表
在本地仓库根目录执行命令:git ls-files | sort -f | uniq -di
输出结果就是仓库内所有存在大小写冲突的重复文件条目,包含你提到的所有历史遗留小写命名旧文件。 - 从Git索引中移除不需要的旧遗留文件
针对每一个确认是旧版本、需要从远程仓库删除的重复文件(比如历史遗留的小写命名旧文件),执行如下命令:
以需要删除旧文件src/utils.js、保留正常使用的Src/Utils.js为例:git rm --cached src/utils.js
加入--cached参数的作用是仅从Git的版本索引中移除该条目,不会删除本地磁盘上正在正常使用的同名文件,避免本地文件丢失。 - 提交变更并推送到远程仓库
执行提交命令记录清理操作:git commit -m "清理仓库内历史遗留的大小写重复旧文件"
推送到远程main分支:git push origin main
推送完成后刷新GitHub仓库页面,遗留的重复旧文件就会被移除,再次执行git pull origin main确认无版本差异提示,本地和远程的文件列表会恢复一致。
后续避免同类问题的注意事项
- 统一项目全量文件的命名规范,所有新文件统一使用小写加下划线/中划线的命名规则,从提交源头避免出现大小写差异的同类文件。
- 团队成员统一在本地Git配置中开启
core.ignorecase false,在提交阶段就拦截大小写重复的文件条目。
内容的提问来源于stack exchange,提问作者user11800286
相关产品推荐
相关产品推荐

