避免 Git 文件名大小写出错

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

1. 配置 Git 全局忽略大小写
   在 Windows 上，默认 Git 会忽略大小写。建议全局关闭此行为：

   git config --global core.ignorecase false
   

2. 统一团队命名规范

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

3. 使用 IDE/编辑器插件

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

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

4. 代码提交前检查

   • 使用 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：错误文件名已推送到远程仓库

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

     git push origin main --force
     

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

• 刷新 Git 缓存
  若文件系统未正确识别变更，尝试：

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

三、注意事项

1. Windows 文件系统的限制

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

2. 团队协作风险

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

3. 极端情况处理

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

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

通过 规范命名 + 正确配置 + 操作检查，可大幅减少大小写问题。若问题已发生，优先使用 git mv 或重置缓存修正，避免直接操作文件系统。