作者：程序员平
最近在开发过程中遇到了的一个诡异的问题：我们的项目中有一个目录原本命名为v1，已经添加并纳入了Git管理。后来由于规范调整，我们将目录名从v1改为V1，修改了代码命令空间并提交代码Action自动化部署后却发现服务器上的代码运行出现了问题——系统依然尝试访问v1目录，导致各种路径错误。最近我就在一次部署中因为这个问题踩了坑，本文记录这个问题的复现过程、根因分析以及解决，希望能帮到你。
最近在开发过程中遇到了一个诡异的问题：我们的项目中有一个目录原本命名为v1，已经添加并纳入了Git管理。后来由于规范调整，我们将目录名从v1改为V1，提交代码后却发现服务器上的代码运行出现了问题——系统依然尝试访问v1目录，导致各种路径错误。
一、背景描述
这个示例我就新建一个测试的仓库进行演示!
项目结构中原本有一个目录为 v1/（小写），已经被添加到 Git 仓库中。
后来为了统一风格，我将目录名改成了 V1/（首字母大写），并正常修改代码执行提交/push
一切看起来都没问题，直到部署到服务器后，服务报错找不到 V1 目录。登录服务器后发现目录仍然是 v1，并未变成大写。此时我才意识到，这不是部署的问题，而是 Git 根本没有识别到目录名的大小写变化。
其实单独修改目录, 不修改代码就会发现, 将目录名改为大写的V1之后, 其实是没有要提交的内容的
二、 为什么会出现这个问题？
1. Git 默认配置下不区分大小写
Git在默认配置下对文件名是大小写不敏感的。这意味着当你把v1改为V1时，Git可能不会将其识别为一个真正的更改，特别是如果你没有明确配置Git为大小写敏感。
这意味着：在 macOS 或 Windows 上将目录 v1 改名为 V1，文件系统会认为这不是“真正的重命名”，Git 也就不会记录这个变动。
如果你是在本地开发（Windows/macOS），然后部署到 Linux 服务器（大小写敏感），问题就暴露了。
2. Git的工作机制
- 当你在本地重命名文件夹时：
-
- 本地文件系统会反映这个更改
- Git可能不会将此识别为重命名操作，而是认为你删除了v1并添加了V1
- 如果Git配置为不区分大小写，它可能完全忽略这个更改
3. 文件系统的差异
不同操作系统对文件名大小写的处理方式不同：
- Windows/macOS(默认)：文件系统通常不区分大小写
- Linux/Unix：文件系统通常区分大小写
三、 如何解决？
方法一
使用 git mv 强制重命名(临时)
# 先改成一个临时名称（不同名）git mv v1 tempgit commit -m "Temp rename"
# 再改为最终名称git mv temp V1git commit -m "Rename v1 to V1"git push
这样就能强制 Git 识别为两个变更，从而在使仓库中都能正确更新。
方法二
修改 Git 配置以区分大小写（永久）
配置Git为大小写敏感：
git config core.ignorecase false
这个配置告诉 Git 让它在本地也“强制”区分大小写。
四、 总结****
Git的大小写不敏感特性在跨平台开发中可能成为隐形杀手, 特别是在一开始就没有统一文件命名规范的时候。通过了解其工作原理并采取适当的预防措施，可以避免这类问题的发生。记住，在重命名文件或目录时，最好使用git mv命令，并确保团队中每个人都配置了正确的大小写敏感设置。
