避免Git文件名大小写出错解决过程

一、如何避免大小写出错？

配置 git 全局忽略大小写

• 在 windows 上，默认 git 会忽略大小写。
• 建议全局关闭此行为：

git config --global core.ignorecase false

统一团队命名规范

• 强制约定文件名全小写（如 config.json）或特定格式（如驼峰式 appcomponent.ts）。
• 在项目文档中明确规范，并通过代码审查工具（如 eslint）检查文件名。

使用 ide/编辑器插件

• vs code、webstorm 等工具可提示文件名大小写差异。
• 开启文件系统的区分大小写功能（windows 10/11 支持，需手动启用）：

# 对特定文件夹启用区分大小写
fsutil file setcasesensitiveinfo "<文件夹路径>" enable

代码提交前检查

• 使用 git status 确认文件名变更是否被正确识别。
• 通过 git 钩子（如 pre-commit）自动检测大小写冲突（需脚本支持）。

二、出现大小写出错时如何解决？

场景 1：本地仓库文件名大小写错误

方法 1：使用 git mv 重命名

git mv oldname.txt temp.txt  # 先重命名为临时名称
git mv temp.txt newname.txt  # 再改为正确大小写
git commit -m "fix: correct filename case"

方法 2：删除后重新添加

git rm --cached oldname.txt  # 从 git 删除记录（保留本地文件）
git add newname.txt          # 添加正确名称
git commit -m "fix: re-add file with correct case"

场景 2：错误文件名已推送到远程仓库

强制修正远程历史

• 本地修正文件名并提交。
• 强制推送覆盖远程分支（谨慎操作，需团队协调）：

git push origin main --force

场景 3：windows 文件系统混淆大小写

刷新 git 缓存

若文件系统未正确识别变更，尝试：

git rm -r --cached .  # 删除所有缓存
git add .             # 重新添加文件
git commit -m "fix: reset cache for case sensitivity"

三、注意事项

windows 文件系统的限制

• 即使 git 配置为区分大小写，windows 文件系统默认仍可能不区分。
• 可通过 fsutil 命令为项目目录启用区分大小写（需管理员权限）。

团队协作风险

• 强制推送（--force）可能破坏他人代码，需提前通知团队。
• 建议在分支上操作并通过 merge request 提交变更。

极端情况处理

• 若问题复杂，直接删除本地仓库并重新克隆：

rm -rf .git          # 删除本地仓库配置
git clone <repo-url> # 重新克隆

通过 规范命名 + 正确配置 + 操作检查，可大幅减少大小写问题。

若问题已发生，优先使用 git mv 或重置缓存修正，避免直接操作文件系统。

四、总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持代码网。