Git
简体中文 ▾ Topics ▾ Latest version ▾ git-reflog last updated in 2.43.0

名称

git-reflog - Manage reflog information

概述

git reflog [show] [<日志选项>] [<引用>]
git reflog expire [--expire=<时间>] [--expire-unreachable=<时间>]
	[--rewrite] [--updateref] [--stale-fix]
	[--dry-run | -n] [--verbose] [--all [--single-worktree] | <引用>…​]
git reflog delete [--rewrite] [--updateref]
	[--dry-run | -n] [--verbose] <引用>@{<标注>}…​
git reflog exists <引用>

描述

该命令管理记录在引用日志中的信息。

引用日志(或称 "reflogs")记录了本地仓库中分支和其他引用的提示更新时间。参考日志在各种 Git 命令中都很有用,可以用来指定引用的旧值。例如,HEAD@{2} 表示 “两步前 HEAD 所在的位置”,master@{one.week.previous} 表示 “一周前本仓库中 master 所在的位置”,等等。详见 gitrevisions[7]

该命令采取不同的子命令,并根据子命令有不同的选项:

"show" 子命令(也是默认命令,在没有任何子命令的情况下)显示命令行中提供的引用日志(或默认的 HEAD)。引用日志包括所有最近的操作,此外,HEAD 引用日志还记录分支切换。 git reflog showgit log -g --abbrev-commit --pretty=oneline 的别名;详见 git-log[1]

"expire" 子命令用于删除旧的引用日志条目。超过 expire 时间的条目,或超过 expire-unreachable 时间且当前 tip 无法访问的条目,都会从引用日志中删除。 终端用户通常不会直接使用该子项,请参见 git-gc[1]

"delete" 子命令用于删除应用日志中的单个条目。其参数必须是一个_exact_条目(例如"git reflog delete master@{2}")。最终用户通常也不会直接使用该子命令。

"exists" 子命令检查引用是否有引用日志。 如果引用日志存在,则以零状态退出;如果不存在,则以非零状态退出。

选项

show(显示)的选项

git reflog show 接受 git log 接受的任何选项。

expire 的选项

--all

处理所有引用的引用日志。

--single-worktree

默认情况下,如果指定了 `--all`选项,所有工作区的引用日志都会被处理。此选项限制只处理当前工作区的引用日志。

--expire=<时间>

剪除超过指定时间的条目。如果未指定此选项,则过期时间取自配置设置 gc.reflogExpire,默认为 90 天。expire=all 会剪除任何年龄的条目;--expire=never 会关闭剪除可到达条目的功能(但请参阅 --expire-unreachable)。

--expire-unreachable=<时间>

剪除从分支当前顶端无法到达的超过 <时间> 的条目。如果未指定此选项,则过期时间取自配置设置 gc.reflogExpireUnreachable,默认为 30 天。--expire-unreachable=all 会修剪无法访问的条目,无论其年龄大小;--expire-unreachable=never 会关闭对无法访问条目的早期修剪(但请参见 --expire)。

--updateref

如果前一个顶层条目已被剪枝,则将引用更新为顶层引用日志条目的值(即 <引用>@{0})。 (符号引用将忽略此选项)

--rewrite

如果重写日志条目的前一个条目被剪枝,则调整其 “旧” SHA-1,使其等于现在排在其前面的条目的 “新” SHA-1 字段。

--stale-fix

删除任何指向 “中断提交” 的引用日志条目。中断提交是指从任何引用提示都无法到达的提交,它直接或间接地指向丢失的提交、树或二进制对象。

这种计算涉及遍历所有可到达的对象,也就是说,其代价与 git prune 相同。 它的主要目的是修复旧版本 Git 垃圾回收所造成的损坏,因为旧版本的 Git 无法保护引用日志所引用的对象。

-n
--dry-run

不要实际修剪任何条目,只需显示本应修剪的内容。

--verbose

在屏幕上打印额外信息。

delete(删除)的选项

git reflog delete accepts options --updateref, --rewrite, -n, --dry-run, and --verbose, with the same meanings as when they are used with expire.

GIT

属于 git[1] 文档

scroll-to-top