使用git filter-branch删除旧提交API密钥时出现refs未变更警告如何解决

出现Ref is unchanged警告的核心原因是git遍历所有提交历史后，没有找到任何匹配你指定删除规则的内容，常见触发场景如下：

• 路径匹配错误：你命令中指定的'workout_log/lib/key.properties'路径和该文件在仓库中的实际提交路径不一致。git对路径大小写敏感，哪怕你使用的是Windows、macOS这类默认路径大小写不敏感的系统，git匹配路径时也会严格区分大小写，路径层级、文件名任何一处不符都会导致匹配失败。你可以先运行git log --all --full-history -- workout_log/lib/key.properties 命令检查是否有提交记录关联该路径，如果没有输出即可确认路径不匹配或者文件从未提交。
• 文件从未进入Git提交历史：如果该文件从一开始就被加入了.gitignore规则，或者你在首次提交前就删除了该文件，那么Git历史里根本不存在这个文件的记录，自然没有可删除的内容。
• 已执行过一次历史改写操作：git filter-branch 执行成功后会自动在.git/refs/original/路径下存原始引用的备份，如果你已经跑过一次删除命令，当前的分支引用已经是处理后的状态，再次执行命令就会提示无变更。如果需要重新执行，可以先运行rm -rf .git/refs/original/删除备份后再重试。
• 分支匹配错误：如果你的仓库默认分支不是main，或者泄露密钥的提交只存在于其他非main分支、未打标签的提交中，也可能出现该提示。

另外补充：目前Git官方更推荐使用git filter-repo工具进行历史改写操作，相比git filter-branch效率更高、边界case处理更完善，你可以尝试切换工具完成密钥删除操作。

内容的提问来源于stack exchange，提问作者Artur Sikora