HSTR 命令行历史工具配置完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01108/article/details/148527658

HSTR 命令行历史工具配置完全指南

hstr bash and zsh shell history suggest box - easily view, navigate, search and manage your command history. 项目地址: https://gitcode.com/gh_mirrors/hs/hstr

前言

HSTR 是一个功能强大的命令行历史工具，它可以帮助开发者高效地管理和搜索命令行历史记录。本文将全面介绍 HSTR 的配置方法，从基础配置到高级定制，帮助您充分发挥 HSTR 的强大功能。

基础配置

初始化配置

要开始使用 HSTR，首先需要将其集成到您的 shell 环境中。根据您使用的 shell 类型，执行以下相应命令：

# 对于 Bash 用户
hstr --show-bash-configuration >> ~/.bashrc

# 对于 Zsh 用户
hstr --show-zsh-configuration >> ~/.zshrc

执行完毕后，不要忘记运行 source 命令使配置生效：

# Bash 用户
source ~/.bashrc

# Zsh 用户
source ~/.zshrc

键盘快捷键绑定

检查当前键位映射

在绑定快捷键前，建议先检查当前的键位映射设置：

bind -v | grep editing-mode
bind -v | grep keymap

Bash Emacs 键位映射（默认）

这是大多数 Bash 用户的默认设置，可以绑定以下快捷键：

# 绑定到 Ctrl-r
bind '"\C-r": "\C-a hstr -- \C-j"'

# 绑定到 Ctrl-Alt-r
bind '"\e\C-r":"\C-a hstr -- \C-j"'

# 绑定到 Ctrl-F12
bind '"\e[24;5~":"\C-a hstr -- \C-j"'

Bash Vim 键位映射

如果您使用 Vim 风格的键位映射：

bind '"\C-r": "\e^ihstr -- \n"'

Zsh Emacs 键位映射

Zsh 用户的绑定方式：

bindkey -s "\C-r" "\C-a hstr -- \C-j"

实用别名设置

为方便使用，可以设置一个简短的别名：

alias hh=hstr

高级配置选项

HSTR 通过 HSTR_CONFIG 环境变量接受一系列逗号分隔的配置选项。

显示风格配置

颜色设置

# 启用彩色显示
export HSTR_CONFIG=hicolor

# 黑白模式
export HSTR_CONFIG=monochromatic

界面布局

# 提示符显示在底部
export HSTR_CONFIG=prompt-bottom

# 帮助信息显示在另一侧
export HSTR_CONFIG=help-on-opposite-side

# 隐藏基本帮助
export HSTR_CONFIG=hide-basic-help

# 隐藏所有帮助
export HSTR_CONFIG=hide-help

历史记录视图

# 默认显示原始历史记录
export HSTR_CONFIG=raw-history-view

# 默认显示收藏命令
export HSTR_CONFIG=favorites-view

搜索过滤选项

# 正则表达式匹配
export HSTR_CONFIG=regexp-matching

# 子字符串匹配
export HSTR_CONFIG=substring-matching

# 关键词匹配（默认）
export HSTR_CONFIG=keywords-matching

# 区分大小写
export HSTR_CONFIG=case-sensitive

# 保留重复命令
export HSTR_CONFIG=duplicates

收藏命令管理

# 静态收藏列表（不自动调整顺序）
export HSTR_CONFIG=static-favorites

# 跳过注释行
export HSTR_CONFIG=skip-favorites-comments

黑名单功能

首先启用黑名单功能：

export HSTR_CONFIG=blacklist

然后在 ~/.hstr_blacklist 文件中列出要忽略的命令，例如：

cd
my-private-command
ls
ll

其他实用选项

# 删除时不确认
export HSTR_CONFIG=no-confirm

# 显示删除确认信息
export HSTR_CONFIG=verbose-kill

# 显示警告信息
export HSTR_CONFIG=warning

# 调试模式
export HSTR_CONFIG=debug

组合配置示例

# 彩色显示+区分大小写
export HSTR_CONFIG=hicolor,case-sensitive

# 收藏视图+黑白模式+底部提示
export HSTR_CONFIG=favorites-view,monochromatic,prompt-bottom

# 关键词匹配+彩色+调试模式
export HSTR_CONFIG=keywords-matching,hicolor,debug

Shell 历史记录设置优化

Bash 历史记录优化

# 增加历史记录容量
export HISTFILESIZE=10000
export HISTSIZE=${HISTFILESIZE}

# 实时同步历史记录
export PROMPT_COMMAND="history -a; history -n; ${PROMPT_COMMAND}"

# 追加而非覆盖历史记录
shopt -s histappend

# 忽略以空格开头的命令
export HISTCONTROL=ignorespace