平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“git一次大小写目录名导致远程仓库出现两套代码的踩坑及解决”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。
前言
在这个场景下,在 Windows 上开发,有时候我们会顺手把目录名从小写改成驼峰,比如 emailconfig → emailConfig
改完后一看本地文件正常,IDE 也没报错,就放心地继续开发了
结合项目来看,push 到远程后,却发现——仓库里居然同时存在 emailconfig 和 emailConfig 两套代码! 更诡异的是,本地 git status 干干净净
打开远程仓库
ruoyi-ui/src/views/system/emailconfig/ ← 旧的,还在!
ruoyi-ui/src/views/system/emailConfig/ ← 新的,也在!
本地执行 git status,输出却极其干净:
On branch xx
Your branch is up to date with 'origin/xx'.
1. 原理
1.Windows 的 NTFS 默认是大小写不敏感的
emailconfig 和 emailConfig 在 Windows 眼里是同一个文件夹
结合项目来看,手动重命名后,文件系统只是更新了显示名称,底层路径对 Git 来说"看起来没变"
2.Git 的 core.ignorecase 默认是 true
落到代码里,Git 在 Windows 安装时,会自动把 core.ignorecase 设为 true
这意味着 Git 默认忽略仅大小写变化的文件名/目录名变更
3.远程仓库(Linux)是大小写敏感的
2. 实战
先确认 Git 索引里到底存了几套路径:
git ls-files | findstr "emailconfig"
输出:
ruoyi-ui/src/views/system/emailconfig/components/ConfigModal.vue
ruoyi-ui/src/views/system/emailconfig/components/TestModal.vue
ruoyi-ui/src/views/system/emailconfig/index.vue
ruoyi-ui/src/views/system/emailConfig/components/ConfigModal.vue
ruoyi-ui/src/views/system/emailConfig/components/TestModal.vue
ruoyi-ui/src/views/system/emailConfig/index.vue
实锤了:Git 索引里同时存在 emailconfig 和 emailConfig 两套记录
落到代码里,而 git status 之所以不显示,是因为 Windows 文件系统把这两个路径映射到了同一个物理目录,Git 认为"工作区和索引一致"
截图如下所示:

具体步骤如下所示:
# 1. 关键:让 Git 临时区分大小写,防止误删大写的目录
git config core.ignorecase false
# 2. 只从 Git 索引中删除旧的小写目录(--cached 不碰本地文件)
git rm -r --cached ruoyi-ui/src/views/system/emailconfig
# 3. 把正确的大写目录重新加入索引
git add ruoyi-ui/src/views/system/emailConfig
# 4. 查看状态,应该能看到大量 delete 和 rename
git status
# 5. 提交
git commit -m "refactor: remove duplicate emailconfig, keep emailConfig"
# 6. 推送
git push origin xx
# 7. 恢复设置(防止以后踩坑)
git config core.ignorecase true
注意事项:
- 落到代码里,不要直接 rd /s /q 删除 Windows 大小写不敏感,直接删除 emailconfig 可能会误删 emailConfig 的物理文件
- 不要长期保持
ignorecase=false这个设置在团队协作中容易引发冲突,改完记得恢复
总结
从实现思路看,总的来说,git大小写目录名适合结合实际项目边做边理解。先抓住核心思路,再逐步补上细节和边界处理,最后效果会更稳定,也更容易复用。

