避免 Git 文件名大小写出错

配置 Git 全局忽略大小写

在 Windows 上，默认 Git 会忽略大小写。建议全局关闭此行为：
bash 复制代码
```
git config --global core.ignorecase false
```
统一团队命名规范
- 强制约定文件名全小写（如 config.json）或特定格式（如驼峰式 AppComponent.ts）。
- 在项目文档中明确规范，并通过代码审查工具（如 ESLint）检查文件名。
使用 IDE/编辑器插件
- VS Code、WebStorm 等工具可提示文件名大小写差异。
- 开启文件系统的区分大小写功能（Windows 10/11 支持，需手动启用）：
  powershell 复制代码
```
# 对特定文件夹启用区分大小写
fsutil file setCaseSensitiveInfo "<文件夹路径>" enable
```
代码提交前检查
- 使用 git status 确认文件名变更是否被正确识别。
- 通过 Git 钩子（如 pre-commit）自动检测大小写冲突（需脚本支持）。

方法 1：使用 git mv 重命名

bash 复制代码

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

方法 2：删除后重新添加

bash 复制代码

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

强制修正远程历史
1. 本地修正文件名并提交。
2. 强制推送覆盖远程分支（谨慎操作，需团队协调）：
  bash 复制代码
```
git push origin main --force
```

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

bash 复制代码

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

Windows 文件系统的限制
- 即使 Git 配置为区分大小写，Windows 文件系统默认仍可能不区分。
- 可通过 fsutil 命令为项目目录启用区分大小写（需管理员权限）。
团队协作风险
- 强制推送（--force）可能破坏他人代码，需提前通知团队。
- 建议在分支上操作并通过 Merge Request 提交变更。
极端情况处理
- 若问题复杂，直接删除本地仓库并重新克隆：
  bash 复制代码
```
rm -rf .git          # 删除本地仓库配置
git clone <repo-url> # 重新克隆
```

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