切换Git分支时文件名大小写随机变更问题求助

结合你的环境（Windows 10、NTFS映射网络驱动器、Git 2.30.0），这个问题的根源是Windows文件系统特性、网络驱动器的缓存延迟和旧版Git的处理逻辑共同导致的，下面一步步拆解原因和解决方案：

问题原因分析 #

• NTFS与网络映射盘的冲突：NTFS本身是「大小写不敏感但保留大小写」的文件系统，但通过SMB协议挂载的网络映射盘，服务器端的缓存或者协议传输延迟，会导致Git读取文件名时拿到的大小写状态不稳定——有时候是分支里存储的正确大小写，有时候是被网络层处理后的小写。
• Git配置的误区：你尝试把core.ignorecase改成false，但Windows的NTFS并不真正支持大小写区分，这反而让Git和文件系统的逻辑冲突，加剧了大小写显示的随机性；而默认的true配置下，旧版Git在网络盘上的缓存机制会错误地复用过时的文件名信息。
• 旧版Git的bug：Git 2.30.0是比较老的版本（2021年发布），后续版本修复了不少Windows网络驱动器下的大小写处理问题，这也是问题出现的诱因之一。

分步解决方案 #

1. 优先升级Git到最新稳定版 #

旧版Git对Windows网络存储的兼容性确实有缺陷，升级到最新版（比如2.40+）能直接解决大部分这类边缘问题。你可以直接去Git官网下载安装包覆盖安装，过程很简单。

2. 调整Git的核心配置 #

针对Windows NTFS网络映射盘，需要正确配置两个关键参数，在仓库目录下执行以下命令：

git config core.ignorecase true
git config core.fscache false

• core.ignorecase=true：让Git适配Windows大小写不敏感的文件系统，避免强制区分大小写导致的冲突。
• core.fscache=false：关闭Git的文件系统缓存，防止因为网络盘的延迟，Git读取到过时的文件名大小写信息。

3. 重建Git索引，统一文件名大小写 #

先切换到你认为文件名大小写正确的分支（比如master），手动确保所有文件的大小写都是你期望的状态（Windows里修改文件名大小写需要先改成临时名，再改回目标名，比如somecode.py→temp.py→someCode.py），然后执行以下命令让Git重新索引文件：

git rm -r --cached .
git add .
git commit -m "Fix filename case consistency in index"

这一步会清空Git的缓存索引，重新读取当前文件系统的正确文件名，确保仓库索引里的文件名大小写和实际一致。

4. 检查网络共享的SMB配置 #

如果你的网络驱动器是SMB共享，联系服务器管理员检查SMB服务的配置，确保启用了「保留文件名大小写」的选项——有些服务器默认的SMB配置会自动将文件名转为小写，这也会导致Git读取到的文件名不稳定。

后续注意事项 #

• 在Windows环境下开发，尽量统一文件名的大小写规范（比如全小写或者驼峰式），避免混用不同大小写的文件名，从根源减少这类问题。
• 如果条件允许，尽量把Git仓库放在本地磁盘而不是网络映射盘，网络盘的IO延迟和协议兼容性问题很容易触发Git的边缘情况。

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