如何在GitHub中修改文件名大小写并保留文件提交历史
2026-4-29
解决GitHub PR中文件名大小写变更导致的历史断裂问题
这个问题我之前帮好几个开发者排查过，核心原因是GitHub默认的diff检测逻辑和本地Git的重命名识别规则不完全一致。别担心，有两种靠谱的解决方法：
方法一：开启PR的重命名检测（最快最省事）
GitHub的PR页面其实自带重命名识别开关，只是默认可能没打开：
- 打开你的PR页面，切换到「Files Changed」视图
- 点击右上角的齿轮图标（「Settings」）
- 找到并勾选「Detect renames」选项
- 页面会自动刷新，这时候原本显示为新增/删除的文件应该会变成「Rename」，提交历史也会关联起来
这个方法不需要修改任何提交，直接在GitHub界面操作就行，适合已经提交了PR的情况。
方法二：用git mv显式记录重命名（更稳妥）
如果开启检测后还是没识别出来，大概率是因为Git没有明确记录这是重命名操作（比如你是手动修改文件名后直接add的）。这时候可以重新用Git的重命名命令来提交：
- 确保本地分支没有未提交的变更，有就先暂存：
git stash - 执行重命名命令，注意大小写要准确：
git mv OldIncorrectFileName newcorrectfilename - 提交这个变更：
git commit -m "Fix filename case: properly rename to correct casing" - 推送到远程分支：
git push - 回到PR页面刷新，就能看到文件被识别为重命名，历史也会完整保留
如果已经提交了错误的新增/删除记录，还可以用git rebase来修改历史（仅限自己的分支，没被其他人拉取过的情况）：
- 找到重命名之前的提交：
git log --oneline - 执行交互式变基：
git rebase -i <commit-hash> - 把对应的提交改成
edit，然后用git mv替换手动的文件变更，最后保存并完成变基：git rebase --continue，再强制推送到远程：git push -f
补充说明
本地Git默认会自动检测重命名（只要文件相似度超过50%），但GitHub的diff检测默认可能没开启这个功能，或者阈值更高。用git mv显式告诉Git这是重命名，能让GitHub更准确地识别变更类型，避免历史断裂。
内容的提问来源于stack exchange，提问作者Tim Randall
