git reflog用法

文章目录

[git reflog用法](#git reflog用法)
- - [1. 如何浏览（显示）更多条目](#1. 如何浏览（显示）更多条目)
  - [2. 如何显示更详细的信息](#2. 如何显示更详细的信息)
  - [3. 如何让 Reflog 保存更久（为什么旧的记录会消失？）](#3. 如何让 Reflog 保存更久（为什么旧的记录会消失？）)
  - 总结

默认情况下， git reflog 会在一个分页器（比如 less）中显示，你可能以为它只显示了一屏的内容。实际上它记录了很多，只是需要你浏览。

下面我将从如何浏览更多 、如何显示更详细的信息 ，以及如何让 reflog 保存更久三个方面来详细解答。

1. 如何浏览（显示）更多条目

默认的 git reflog 行为很像 git log，如果内容超过一屏，它会自动进入一个可滚动的视图。

向下滚动 ：按 ↓ 键或 Space (空格键) 翻页。
向上滚动 ：按 ↑ 键或 b 键。
退出浏览 ：按 q 键。

如果你想一次性在终端里看到所有 reflog 记录（不进入分页器），可以使用 --no-pager 参数：

bash 复制代码

git --no-pager reflog

这会将所有 reflog 历史直接打印到你的终端里，你可以自由地上下滚动查看。

如果你只想看指定数量的最近记录，可以使用 -n 或 --max-count 参数：

bash 复制代码

# 显示最近的 30 条记录
git reflog -n 30
# 或者
git reflog --max-count=30

2. 如何显示更详细的信息

默认的 git reflog 输出格式非常简洁。你可以让它显示更多有用的信息，比如确切的时间。

显示相对时间 (e.g., "2 hours ago")

bash 复制代码

git reflog --date=relative

输出示例：

复制代码

a1b2c3d (HEAD -> main) HEAD@{2 hours ago}: pull: Fast-forward
f4e5d6c HEAD@{1 day ago}: commit: My last work before pull

显示标准格式的绝对时间

bash 复制代码

git reflog --date=iso

输出示例：

复制代码

a1b2c3d (HEAD -> main) HEAD@{2023-10-27 15:30:00 +0800}: pull: Fast-forward
f4e5d6c HEAD@{2023-10-26 11:20:00 +0800}: commit: My last work before pull

使用 git log -g (终极技巧)

git reflog 实际上是 git log -g --abbrev-commit --pretty=oneline 的一个别名。git log -g (或 --walk-reflogs) 是更强大的命令，它允许你使用 git log 所有强大的格式化功能来展示 reflog！

例如，你想看一个更详细、更美观的 reflog，可以这样做：

bash 复制代码

# -g 就是 --walk-reflogs 的缩写
# --pretty=... 自定义格式
git log -g --pretty=format:'%h %gd %ar: %gs'

%h: 缩短的 commit 哈希
%gd: reflog 选择器，如 HEAD@{0}
%ar: 相对时间
%gs: commit 信息的第一行

这个命令的输出会非常清晰，强烈推荐：

复制代码

a1b2c3d HEAD@{0} 2 hours ago: pull: Fast-forward
f4e5d6c HEAD@{1} 1 day ago: commit: My last work before pull
g7h8i9j HEAD@{2} 2 days ago: commit: Some older work

3. 如何让 Reflog 保存更久（为什么旧的记录会消失？）

你可能会发现非常非常久远的操作在 reflog 里找不到了。这是因为 Git 会定期"清理"过期的 reflog 条目，以防止仓库文件无限增大。

这个清理行为由两个配置项控制：

gc.reflogExpire: 针对可达 (reachable) 的 reflog 条目。这些是你当前分支历史中还能访问到的 commit。默认是 90天。
gc.reflogExpireUnreachable: 针对不可达 (unreachable) 的 reflog 条目。比如你 reset --hard 丢弃的、或者 rebase 掉的旧 commit。这些是你最可能需要 reflog 来恢复的！默认是 30天。

这些清理操作通常在 git gc (garbage collection, 垃圾回收) 时触发。

如何查看当前的配置？

bash 复制代码

git config --get gc.reflogExpire
git config --get gc.reflogExpireUnreachable

如何延长保存时间？

如果你希望 reflog 保存更长时间（比如半年），可以修改这个配置。

bash 复制代码

# 将不可达条目的保存时间延长到 180 天
# --global 参数会对你系统上所有的 git 仓库生效
git config --global gc.reflogExpireUnreachable "180 days"

# 如果只想对当前这个项目生效，去掉 --global
git config gc.reflogExpireUnreachable "180 days"

你甚至可以设置为 never 来永不过期，但这通常不推荐 ，因为它会让你的 .git 目录持续膨胀。

bash 复制代码

# 不推荐：除非你有特殊理由，否则不要这么做
git config gc.reflogExpire "never"

总结

你的需求	推荐命令	说明
浏览所有记录	`git --no-pager reflog`	一次性打印所有 reflog，方便在终端里滚动。
只看最近几条	`git reflog -n 20`	显示最近的 20 条记录。
显示更友好的时间	`git reflog --date=relative`	将时间戳显示为 "2 hours ago" 这种形式。
显示最详细的信息	`git log -g --pretty=format:'%h %gd %ar: %gs'`	终极大法，结合 `git log` 的格式化功能，输出清晰。
延长 reflog 保存期	`git config gc.reflogExpireUnreachable "180 days"`	让 "后悔药" 的保质期更长，例如从 30 天延长到 180 天。

希望这些信息能帮你更好地使用 git reflog 这个强大的工具！