返回
Featured image of post Atuin 安装与配置:终端历史搜索、同步和常用命令

Atuin 安装与配置:终端历史搜索、同步和常用命令

使用 Atuin 搜索终端历史:介绍 CLI 安装、Zsh 集成、旧历史导入、TOML 配置和可选加密同步,区分本地搜索与自建同步服务。

Atuin 解决什么问题

Atuin 将 Shell 历史存入本地 SQLite 数据库,并保留目录、退出状态等上下文。你可以跨终端会话搜索已有命令,减少反复回忆参数的时间。

先把本地搜索用起来,再决定是否需要跨机器同步。CLI 不依赖 Python,日常本地搜索也不需要注册账号或运行同步服务器。

安装 CLI 并接入 Zsh

macOS 使用 Homebrew 时可以执行:

brew install atuin
atuin --version

Linux、Windows 和其他包管理器请按官方安装文档选择对应方式。旧文中的 pip install atuin 不是这里介绍的 Atuin CLI 的安装方式。

Zsh 用户在 ~/.zshrc 中添加一次:

eval "$(atuin init zsh)"

打开新终端,再导入已有历史:

atuin import auto

atuin init 后的参数表示 Shell 类型。Bash、Fish、PowerShell 的接入方式不同,应按文档配置各自的启动文件。

配置文件使用 TOML

配置采用 TOML。当前文档的默认路径是 ~/.atuin/config.toml,旧安装可能继续使用 ~/.config/atuin/config.toml 或 XDG 路径。ATUIN_HOME、ATUIN_CONFIG_DIR 也会影响位置,修改前先核对当前安装。例如:

search_mode = "fuzzy"
filter_mode = "global"

修改后重新打开搜索界面检查效果。配置项以官方配置文档及安装版本为准;旧文中的 config.yaml 路径不适用于该配置。

搜索、检查,再复用命令

完成 Shell 集成后,按 Ctrl+R 打开交互搜索,输入记得的命令片段。执行前检查目录、主机、参数和环境,避免把历史中的生产操作带到错误的上下文。

也可以在命令行查看历史:

atuin history list
atuin search "git"
atuin search --help

如果 Ctrl+R 仍然是原来的搜索界面,检查初始化代码是否在交互 Shell 中执行,以及后加载的插件是否覆盖了快捷键。

用目录、会话和时间缩小范围

历史较多时,先通过交互界面的过滤模式缩小到相关目录、会话或主机。命令行搜索支持的目录、退出码和时间参数可通过 atuin search --help 确认,具体示例见搜索参考。

优先使用当前版本明确支持的搜索与过滤参数,不要把其他工具的标签、任务运行命令套到 Atuin 上。

日常使用价值

数据库让历史不再局限于一个终端会话;目录和主机上下文则帮助区分看起来相同的命令。搜索到的内容仍需要人工检查,尤其是包含密钥、生产地址或删除参数的命令。

历史记录说明某个命令曾经执行过,不代表现在适合再次执行。

跨机器同步是可选项

需要同步时,再按官方同步指南注册或登录,并配置第二台设备。妥善保存加密密钥,区分账号登录凭据与历史加密密钥的用途。

自建同步服务端是独立的部署工作,当前服务端安装指南使用 atuin-server 二进制。同步前检查历史排除规则,避免把不应保留的敏感命令写入历史。

建议的上手顺序

安装 CLI、接入实际使用的 Shell、导入历史,然后找回三条常用命令。确认本地体验满足需求后,再考虑同步和过滤设置。

命令与文档于 2026 年 10 月 16 日核对,项目实现见 Atuin 仓库。实际快捷键行为取决于安装版本和 Shell 配置。

最后更新于 2026年10月16日 00点00分00秒