bash-preexec for Mac 版
用于 Bash(类似 Zsh)的 preexec 和 precmd 函数
bash-preexec 是什么
bash-preexec 为 Bash 3.1 及以上版本提供类似 Zsh 的 preexec 和 precmd 钩子函数,让 Bash 用户也能获得 Zsh 中那套命令执行前后的回调机制。它已被 Bashhub、iTerm2、Ghostty、WezTerm 和 Atuin 等项目在实际生产中使用。
核心用法很直接:定义 preexec 函数后,它会在命令被读取、即将执行时触发,用户输入的原始字符串作为第一个参数传入;定义 precmd 函数后,它会在每次提示符出现前执行,效果类似 PROMPT_COMMAND,但更灵活、更稳定。除了直接定义函数,还可以把多个函数追加到 $preexec_functions 和 $precmd_functions 两个数组中,方便同时挂载多个钩子。
它解决的是 Bash 缺少标准化命令生命周期钩子的问题,适合需要监听命令执行、做审计记录、终端集成或 shell 增强的开发者与工具作者。默认情况下不支持在子 shell 中触发 preexec,需要手动设置 __bp_enable_subshells 开启。库作者可以通过 bash_preexec_imported 变量检测它是否已加载。
核心用法很直接:定义 preexec 函数后,它会在命令被读取、即将执行时触发,用户输入的原始字符串作为第一个参数传入;定义 precmd 函数后,它会在每次提示符出现前执行,效果类似 PROMPT_COMMAND,但更灵活、更稳定。除了直接定义函数,还可以把多个函数追加到 $preexec_functions 和 $precmd_functions 两个数组中,方便同时挂载多个钩子。
它解决的是 Bash 缺少标准化命令生命周期钩子的问题,适合需要监听命令执行、做审计记录、终端集成或 shell 增强的开发者与工具作者。默认情况下不支持在子 shell 中触发 preexec,需要手动设置 __bp_enable_subshells 开启。库作者可以通过 bash_preexec_imported 变量检测它是否已加载。
如何安装 bash-preexec
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2026-08-24,当前版本 0.7.0,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 0.7.0 | 2026-08-24 | 稳定版 | — | — | — | — |
| 0.6.0 | 2025-08-03 | 稳定版 | — | — | — | — |
| 0.5.0 | 2022-04-20 | 稳定版 | — | — | — | — |
| 0.4.1 | 2020-09-16 | 稳定版 | — | — | — | — |
| 0.4.0 | 2020-08-22 | 稳定版 | — | — | — | — |
| 0.3.7 | 2018-01-15 | 稳定版 | — | — | — | — |
| 0.3.6 | 2017-10-31 | 稳定版 | — | — | — | — |
| 0.3.5 | 2017-10-19 | 稳定版 | — | — | — | — |
| 0.3.4 | 2017-09-24 | 稳定版 | — | — | — | — |
| 0.3.3 | 2017-05-10 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- all
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
安装注意事项
Add the following line to your bash profile (e.g. ~/.bashrc, ~/.profile, or ~/.bash_profile)n [ -f $HOMEBREW_PREFIX/etc/profile.d/bash-preexec.sh ] && . $HOMEBREW_PREFIX/etc/profile.d/bash-preexec.shn
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| bash-preexec | 0.7.0 | MIT | 命令行 | 2,567 |
| powerlevel10k | v1.20.0 | MIT | 命令行 | 1,171 |
| zsh-completions | 0.36.0 | MIT-Modern-Variant AND BSD-3-Clause AND MIT AND Apache-2.0 AND ISC AND NCSA | 命令行 | 2,140 |
| zsh-autocomplete | 26.08.04 | MIT | 命令行 | 838 |