Git_查看已删除文件的历史

0 阅读3分钟

Git_查看已删除文件的历史

文件不见了,第一反应是翻 commit 记录。翻了半天没找到,即使翻到了也很费功夫——其实 git log 就可以解决。

git log 本质是三件事的组合:在哪个范围内找按什么条件过滤用什么格式输出。把这三块拼对了,几条命令就能定位。


命令结构

git log <branch | --all> [过滤参数] [输出参数] -- <path>

输出较多时,git log 默认用 less 分页显示。j / k 上下滚动(一般终端都支持鼠标滚动),q 退出。


参数说明

范围控制

参数说明
--all遍历所有分支和 tag,兜底用
<branch>只看指定分支,比 --all 干净
A..B只看 B 有、A 没有的提交,适合查当前分支的新增改动

过滤参数

--diff-filter=<字母> :按文件操作类型筛选

含义
A新增
M修改
D删除
R重命名

查删除用 --diff-filter=D,查重命名用 R,两者都不排除的话文件可能只是被移走了。

-S "text" :查某段文本"出现或消失"的提交。不知道文件路径,只记得某段代码时用这个。

-G "regex" :按正则匹配 diff 内容,比 -S 更宽松。

举个例子,如果某次提交把 baseUrl = "http://a.com" 改成了 baseUrl = "http://b.com"-S "baseUrl" 不会命中(因为该字符串总数没变),但 -G "baseUrl" 会命中(因为 diff 里有包含 baseUrl 的改动行)。


输出参数

参数说明
--name-status显示文件名 + 操作状态(A/M/D/R),最常用
--name-only只列文件名,不带状态
--summary显示 delete mode / create mode,直观看结构变化
--full-history不省略 merge 路径,文件被合并覆盖时普通 log 可能查不到

路径限定

-- <path>

-- 后面跟路径,区分参数和文件名,建议始终写上。支持 glob,但不同 shell 行为有差异,用通配符时注意加引号。

** 匹配任意层级目录,记不清文件具体在哪个子目录时很有用:

# 只记得文件在 cdn 目录下某处,不知道完整路径
git log --name-status "**/cdn/**/axios.min.js"

这条命令会匹配所有含 cdn 的路径,比如 src/cdn/v3/axios.min.jsassets/cdn/axios.min.js 都能命中。


常用命令

# 查当前分支是否删过指定文件(文件名模糊匹配)
git log --diff-filter=D --summary -- '*axios.min.js'
# 精确查某个分支的删除记录
git log main --diff-filter=D --summary -- '*axios.min.js'
# 全局查,所有分支上指定文件的删除记录
git log --all --diff-filter=D --summary -- '*axios.min.js'
# 查所有变更类型,判断是删除还是重命名
git log --all --name-status -- '*axios.min.js'
# 只知道代码片段,不知道文件在哪
git log -S "axios" -p --all
# 记得目录名但不知道完整路径,用 ** 匹配任意层级
git log --name-status "**/cdn/**/axios.min.js"
# 找到 commit 后看具体改了什么
git show <commit-id>

排查套路

文件消失了,按这个顺序查:

Step 1:先确认文件有没有出现过

git log --all --name-status -- '*axios.min.js'

Step 2:看输出里的状态标记

D   src/cdn/axios.min.js     # 被删了
R100 src/cdn/axios.min.js → src/lib/axios.min.js  # 被移走了

Step 3:找到 commit,看具体内容

git show <commit-id>

几个容易踩的坑

文件"消失"不一定是被删了,常见情况有三种:被 D 标记删除、被 R 重命名/移目录、被 merge 覆盖(普通 log 看不到,要加 --full-history)。

不要一条条翻 commit。--name-status + --diff-filter + -S 才是正确姿势。

知道文件名就用路径查,不知道路径就用 *filename 通配,连文件都不确定就用 -S 搜代码片段。