MacOS下文件夹大小写重命名后，git add/git stash失效原因咨询

背景与现象 #

• 仓库A存在文件夹大小写不一致问题，修改文件夹大小写统一规范后，通过特殊方法完成Git重命名并提交了文件修改。
• 克隆仓库A并切换到目标分支后，部分文件始终处于待暂存状态，执行git add无效；多次执行git stash仍有3个文件留在暂存区。
• 额外发现：远程仓库文件夹名为metricCharts，本地克隆后显示为MetricCharts；执行git stash后，本地文件夹名称变为metricCharts，此时git add可成功完成。

原因解析 #

• Git与文件系统的大小写兼容性问题：Git默认在不区分大小写的文件系统（如Windows NTFS、默认配置的macOS APFS）中，不会主动识别文件名/文件夹的大小写变更——因为这类文件系统会将MetricCharts和metricCharts视为同一个路径，导致Git无法感知到大小写修改的差异。
• 本地路径与Git索引不匹配：克隆仓库时，本地文件系统保留了旧的大写文件夹路径MetricCharts，但Git索引中记录的是远程仓库的小写路径metricCharts。这种索引与本地实际路径的不匹配，让Git无法正确关联文件，出现了无法正常暂存的异常状态。
• git add无效的核心原因：由于路径大小写不匹配，Git在执行git add时，无法找到索引中记录的小写路径对应的本地文件（本地实际是大写路径），或者误判文件状态，导致无法完成暂存操作。
• git stash的修复逻辑：执行git stash时，Git会暂存当前变更并重置工作区与索引，此时会严格按照Git索引中的小写路径创建文件夹，覆盖了本地原有的大写文件夹。路径统一后，Git能正确关联本地文件与索引记录，git add操作自然恢复正常。

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