Git 大小写问题处理
提示
在Git使用过程中，经常会遇到文件名大小写变化不被识别的问题，本文将详细介绍这个问题的原因、解决方案以及如何恢复历史记录
问题现象
当你将目录或文件名从小写改为大写（或反之）时，Git可能不会识别这个变化，以至于远端仓库并没有同步更新，这样别人使用仓库时，可能还是旧的文件/目录名。某些情况下我们还需要在文件中出现对文件/目录名的引用，这样有可能也会带来一些问题
# 例如：将 lowercasedir 改为 UppercaseDir
# Git 可能不会检测到这个变化
问题原因
Git配置的ignorecase设置
Git有一个配置项 core.ignorecase，当设置为 true 时，Git会忽略文件名的大小写差异。
配置优先级
Git配置有多个层级，优先级从高到低为：
- 本地配置 (
.git/config) - 优先级最高 - 全局配置 (
~/.gitconfig) - 优先级中等
文件系统特性
某些文件系统（如macOS的默认文件系统）对大小写不敏感，Git会自动设置 ignorecase = true。
诊断问题
检查当前配置
# 检查全局配置
git config --global core.ignorecase
# 检查本地配置
git config --local core.ignorecase
# 查看所有配置及其来源
git config --list --show-origin | grep core.ignorecase
检查文件状态
# 查看Git跟踪的文件
git ls-files | grep -i "your-directory"
# 查看工作区状态
git status
解决方案
修改Git配置（推荐）
修改本地配置
# 将本地配置设置为false
git config core.ignorecase false
# 验证配置
git config core.ignorecase
删除本地配置（使用全局配置）
# 删除本地配置，使用全局配置
git config --unset core.ignorecase
# 验证配置
git config core.ignorecase
使用git mv命令
# 两步重命名法
git mv old-name temp-name
git mv temp-name New-Name
# 例如：
git mv docs/lowercasedir docs/lowercasedir_temp
git mv docs/lowercasedir_temp docs/UppercaseDir
手动处理
# 1. 删除Git跟踪的文件
git rm -r --cached old-directory
# 2. 添加新的目录结构
git add new-directory
# 3. 提交变化
git commit -m "Rename directory with proper case"
重要注意事项
大小写冲突问题
当你设置 git config core.ignorecase false 后，如果之前已经用不同大小写提交过相同的文件，可能会出现以下问题：
- 重复目录：仓库中同时存在
lowercasedir/和UppercaseDir/目录 - 文件冲突：相同内容但不同大小写的文件同时存在
- 推送失败：某些文件系统不支持大小写冲突
解决方案
清理重复文件（推荐）
# 1. 检查重复文件
git ls-files | grep -i "your-directory"
# 2. 删除小写版本（保留大写版本）
git rm -r --cached docs/lowercasedir
# 3. 提交删除操作
git commit -m "Remove duplicate lowercase directory"
# 4. 推送到远程
git push origin master
使用git mv重命名
# 1. 重命名小写目录为临时名称
git mv docs/lowercasedir docs/lowercasedir_temp
# 2. 重命名为目标名称
git mv docs/lowercasedir_temp docs/UppercaseDir
# 3. 提交变化
git commit -m "Rename directory to proper case"
# 4. 推送到远程
git push origin master
完全重建（谨慎使用）
# 1. 备份当前文件
cp -r docs/lowercasedir /tmp/lowercasedir_backup
# 2. 删除所有相关文件
git rm -r --cached docs/lowercasedir docs/UppercaseDir
# 3. 重新添加正确的大小写版本
git add docs/UppercaseDir
# 4. 提交变化
git commit -m "Rebuild directory with correct case"
# 5. 推送到远程
git push origin master
历史记录恢复
问题说明
使用 git rm --cached 删除重复文件时，会丢失这些文件的提交历史。如果这些历史记录很重要，需要特殊处理来恢复。
恢复方法
方法一：使用git filter-branch重写历史（推荐）
# 1. 创建备份分支
git branch backup-before-case-fix
# 2. 重写历史，将小写目录重命名为临时名称
git filter-branch --tree-filter 'if [ -d "docs/lowercasedir" ]; then mv docs/lowercasedir docs/lowercasedir_temp; fi' --prune-empty HEAD
# 3. 重写历史，将临时目录重命名为目标名称
git filter-branch -f --tree-filter 'if [ -d "docs/lowercasedir_temp" ]; then mv docs/lowercasedir_temp docs/UppercaseDir; fi' --prune-empty HEAD
# 4. 验证历史记录
git log --oneline --follow docs/UppercaseDir/your-file.md | head -10
如果某些文件在重写过程中丢失，可以从备份分支恢复：
# 1. 从备份分支恢复特定目录
git checkout backup-before-case-fix -- docs/UppercaseDir
# 2. 添加恢复的文件
git add docs/UppercaseDir
# 3. 提交恢复操作
git commit -m "Restore directory with complete history"
方法二：使用git filter-repo（更现代的方法）
git filter-repo 是一个用于过滤和清理 Git 仓库历史的工具，它可以高效地批量修改提交历史中的文件内容、删除文件、重命名文件以及进行其他历史重构操作。相较于 git filter-branch，它通常更快且更易于使用。
# 1. 安装git filter-repo
pip install git-filter-repo
# 或者使用brew进行安装
brew install git-filter-repo
# 2. 重写历史
git filter-repo --path-rename docs/lowercasedir:docs/UppercaseDir
# 3. 强制推送
git push origin master --force
验证历史记录
# 检查文件数量
git ls-files | grep -E "docs/UppercaseDir" | wc -l
# 检查历史记录
git log --oneline --follow docs/UppercaseDir/your-file.md | head -10
# 检查是否有重复文件
git ls-files | grep -E "docs/lowercasedir" | wc -l