Git目录大小写重命名后切换分支报错求助

问题根源 #

Windows/macOS默认文件系统是大小写不敏感的，Git在这类环境下默认也会忽略路径的大小写变化，导致直接修改目录大小写时，Git无法识别为路径变更，旧的大写路径会一直留在缓存中，切换分支时就会触发文件覆盖报错。

分步解决流程 #

1. 确保工作区干净

先把未提交的改动暂存或提交，避免冲突：

git stash
# 或者提交所有改动：git add . && git commit -m "save local changes"

2. 临时开启Git大小写敏感

让Git能识别路径的大小写差异：

git config core.ignorecase false

3. 分两次重命名目录（以Components→components为例）

通过临时名称过渡，让Git明确识别路径变更：

• 第一步：重命名为完全不同的临时目录并提交

git mv resources/js/Components resources/js/components_temp
git commit -m "temp rename Components to components_temp"

• 第二步：重命名为目标小写目录并提交

git mv resources/js/components_temp resources/js/components
git commit -m "rename to lowercase components directory"

如果有多个目录需要修改，重复上述步骤即可，或者批量处理后一起提交

4. 清理Git缓存，彻底移除旧路径

有时候Git会缓存旧的大写路径，需要强制清理：

git rm -r --cached .
git add .
git commit -m "clean up cached case-sensitive paths"

5. 恢复Git默认大小写设置（可选）

改完后可以把Git改回默认的大小写不敏感设置：

git config core.ignorecase true

协作成员同步注意事项 #

其他团队成员拉取远程代码后，也需要执行缓存清理步骤，避免本地出现同样的问题：

git pull
git rm -r --cached .
git add .
git commit -m "sync lowercase directory changes"

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