By Jermine

背景

最近在 WSL2 环境下使用 zsh，发现终端的历史记录功能几乎不可用：

  • 按 Ctrl+R 只能逐条翻看历史，效率低下
  • 上下键只能按顺序浏览，不支持按输入的前缀匹配
  • 历史记录只保存了寥寥几条，换个终端窗口就找不到之前敲过的命令

作为一个重度终端用户，每天要敲大量命令。如果能像搜索引擎一样，输入几个关键字就快速匹配到之前执行过的命令，可以显著降低记忆负担，提高操作效率。

本文将记录如何配置 zsh 实现智能的历史命令补全。

当前环境

  • OS: Ubuntu 24.04 LTS (WSL2)
  • Shell: Zsh
  • 已有工具: fzf (已安装但未启用)

问题分析

检查当前的 zsh 配置：

1echo "HISTFILE: $HISTFILE"
2echo "HISTSIZE: $HISTSIZE"
3echo "SAVEHIST: $SAVEHIST"

输出结果：

HISTFILE: /home/jm/.bash_history   # 指向了 bash 的历史文件
HISTSIZE: 30                       # 仅保存 30 条记录
SAVEHIST: 0                        # 设置为 0，等于不保存历史

发现了三个核心问题：

  1. SAVEHIST=0 — 历史记录被设置为不保存到文件，换终端就丢失
  2. HISTSIZE=30 — 内存中只保留 30 条，太少
  3. HISTFILE 指向 .bash_history — zsh 应该使用专用的 .zsh_history
  4. 缺少 zsh 历史相关优化选项 — 没有启用去重、增量追加等特性

优化方案

最终配置

在 ~/.zshrc 中新增以下配置：

 1# ===== 历史记录配置 =====
 2HISTFILE=~/.zsh_history
 3HISTSIZE=100000
 4SAVEHIST=100000
 5
 6setopt EXTENDED_HISTORY      # 记录时间戳
 7setopt HIST_IGNORE_DUPS      # 重复命令只记录一次
 8setopt HIST_IGNORE_SPACE     # 空格开头的命令不记录
 9setopt HIST_VERIFY           # 历史展开时先显示再执行
10setopt SHARE_HISTORY         # 多个 zsh 会话共享历史
11setopt INC_APPEND_HISTORY    # 命令执行后立即追加到文件
12
13# ===== fzf 历史搜索 (Ctrl+R) =====
14source /usr/share/fzf/key-bindings.zsh 2>/dev/null
15source /usr/share/fzf/completion.zsh 2>/dev/null
16
17# ===== 上下键按前缀搜索历史 =====
18autoload -Uz up-line-or-beginning-search down-line-or-beginning-search
19zle -N up-line-or-beginning-search
20zle -N down-line-or-beginning-search
21bindkey '^[[A' up-line-or-beginning-search
22bindkey '^[[B' down-line-or-beginning-search

配置参数说明

历史文件和控制

参数 值 作用
HISTFILE ~/.zsh_history 历史记录存储路径，与 bash 的解耦
HISTSIZE 100000 内存中保留 10 万条
SAVEHIST 100000 文件中也保存 10 万条

setopt 选项

选项 作用
EXTENDED_HISTORY 记录命令执行的时间戳和持续时间
HIST_IGNORE_DUPS 连续重复的命令只保存一次，避免刷屏
HIST_IGNORE_SPACE 以空格开头的命令不记录，适合输密码等敏感场景
HIST_VERIFY 历史展开时先显示，确认后再执行，防误操作
SHARE_HISTORY 多个 zsh 窗口实时共享历史
INC_APPEND_HISTORY 每执行完一条命令立即写入文件

三种搜索方式

配置完成后，你可以用三种不同方式搜索历史命令：

1. Ctrl+R 模糊搜索

这是最强大的方式，使用 fzf 进行实时模糊搜索：

  1. 按 Ctrl+R
  2. 输入任意关键词（如 docker、hugo、git push）
  3. Ctrl+R 或 Ctrl+N / Ctrl+P 在结果间切换
  4. 回车直接执行

2. 上下键按前缀搜索

输入命令的前几个字符，然后按上下箭头：

# 输入 git 后按 ↑，只显示以 git 开头的历史命令
git<↑>
# 结果: git push origin master
#       git commit -m "xxx"
#       git status

3. 普通翻页搜索

如果没输入任何字符，上下键仍然按照传统方式逐条翻页。

生效方法

1# 方法1：重新加载配置
2source ~/.zshrc
3
4# 方法2：退出当前终端，重新打开

使用效果

优化前：

  • 历史记录只有 30 条，换个窗口就没了
  • 想找个之前的命令，只能一遍遍按 ↑ 翻
  • 大脑负担重，记不住复杂命令

优化后：

  • 10 万条历史，换窗口也共享
  • 敲几个字母 + ↑ 直接定位
  • 按 Ctrl+R 模糊搜索，像用搜索引擎一样
  • 重复命令自动去重，历史干净不杂乱

进阶建议

如果觉得还不够，可以考虑安装 atuin — 一个基于 SQLite 的终端历史管理工具，支持加密同步多台机器的历史记录。安装方式：

1bash <(curl --proto '=https' --tlsv1.2 -sSf https://setup.atuin.sh)

配置完成后，atuin 提供 Ctrl+R 替代方案，还支持 Alt+R 搜索历史记录，并可以按目录、退出码等维度过滤历史。

总结

通过简单的几个配置项调整，让 zsh 的历史记录功能从"几乎不可用"变成了"爱不释手"。这对于每天在终端工作的人来说，是一个投入产出比极高的优化 — 只需要花 5 分钟配置，收益却是持续性的效率提升。

核心心法：好工具不是用来看的，是用来减少脑子负担的。把记命令的功夫省下来，去想更重要的事。

相关文章