如何在 Git 提交历史中查找被删除的文件
列出历史上的删除记录:git log --diff-filter=D --summary 显示所选可见历史中的删除文件及所在提交;按内容搜用 git log -S"关键词";确认路径后 git log --all -- <路径> 追踪当前可见路径历史,重命名和浅克隆会限制范围。
Git 能查询本地保留且可达的提交历史;浅克隆或已回收的不可达对象会限制范围。 列出所选历史的删除事件用 git log --all --diff-filter=D --summary;知道大概内容用 git log -S"关键词" 查字符串出现次数变化;确认路径后 git log --all -- 路径 看当前可见历史中的路径变化。
列出所有删除记录
git log --all --diff-filter=D --summary # 保留提交头,才能定位删除提交
# delete mode 100644 src/legacy/old-module.js
# ...
按内容搜索(不记得文件名)
git log -S"calculateDiscount" --oneline --all # 含这段代码的提交变动
git log -G"password|secret" --oneline --all # 正则版本
-S 找指定字符串出现次数发生变化的提交,不是一般全文搜索;-G 匹配补丁中新增/删除行的正则。
按路径追踪
git log --all --oneline -- path/to/file # 该文件的所有历史(跨分支)
git log --all --diff-filter=A -- 路径 # 它在哪次提交诞生
git log --all --diff-filter=D -- 路径 # 在哪次被删
找到之后
git show <删除提交>^:路径 # 看删除前的内容
git restore --source=<删除提交>^ -- 路径 # 恢复到工作区
^ 指第一父提交,删除发生在合并提交时需先检查应从哪个父提交恢复;恢复会覆盖目标工作区文件。路径历史还受重命名启发式和合并简化影响,不等于所有可能历史。
常见问题(FAQ)
Q:文件被重命名过,历史断在改名点怎么办?
git log --follow -- 路径 跨重命名跟踪。注意 --follow 一次只跟一个路径。
Q:整个目录被删了怎么查?
路径参数接受目录:git log --diff-filter=D --summary -- src/old-module/,同样能找到。
Q:想找出"谁删的"?
git log --diff-filter=D --format='%h %an %ad %s' -- 路径,作者、时间、提交说明一目了然。