当前位置：首页 > news >正文

Zsh Alias Preview 预览 zsh 中的命令缩写

news 2026/4/21 5:43:19

原文链接https://www.castamerego.com/blog/zshAliasPreview

alias 用多了之后就有一个问题：敲gco的时候记得它是git checkout，但gcb是什么来着？dcu又是什么？通常的做法是which gcb看一眼再回来重敲一遍，挺打断思路的。笔者写了个 Zsh 插件，在敲命令的时候直接把 alias 展开后的内容显示在 message area，免去这一步

缘起

笔者~/.zshrc里 alias 越攒越多 —— eza 的几个变体、git 的若干缩写、docker compose 一坨。短 alias 敲起来是省事，但回头看历史记录或者教别人用的时候，经常要which xxx一下才想起来到底展开成什么

之前也想过把which绑个快捷键，但本质上还是要打断输入流。笔者想要的是 IDE 里那种 inline hint —— 边敲边看，眼角余光扫一眼就够了。Zsh 的 message area（提示符下面那一行）正好闲着，于是就有了这个插件

功能

主要功能有：

实时预览 alias 展开后的命令，显示在 message area
可以配置只对感兴趣的命令展示，避免被ll之类的低价值预览刷屏
长命令自动截断，不会撑爆下面那一行
仅在内容变化时重绘，避免输入过程中的闪烁

安装

如果还没装过 Zsh 和 Oh My Zsh，可以先看配置 Linux 终端 (zsh) 把基础环境搭好

目前是 Oh My Zsh manual install。先把仓库 clone 到 custom plugins 目录：

git clone https://github.com/Casta-mere/zsh-alias-preview \ ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-alias-preview

然后在~/.zshrc的plugins=(...)里加上zsh-alias-preview，最后 source 一下：

source ~/.zshrc

配置

默认只对git和docker这两个命令的 alias 显示预览 —— 笔者的高频场景就这俩，其他的不太常需要看展开。想加别的命令，在~/.zshrc里做如下修改即可：

~/.zshrc

typeset -ga ALIAS_PREVIEW_COMMANDS=(git docker ls kubectl)

规则很简单：alias 展开后第一个 token 在数组里就显示预览，不在就什么都不做。例如gco='git checkout'会显示，ll='ls -alF'默认不会，加ls进去之后就会

实现思路

整个插件没有引入任何依赖，全靠 Zsh 自身的 ZLE (Zsh Line Editor) 机制。核心就三件事

挂钩重绘事件。Zsh 提供了add-zle-hook-widget，可以在 ZLE 的几个生命周期点（line-init/line-pre-redraw/line-finish等）注入自己的 widget。这里挂在line-pre-redraw上 —— 每次行内容变化、重绘前都会触发：

add-zle-hook-widget line-pre-redraw _preview_alias_message

解析当前命令行的第一个 token。ZLE 把当前输入暴露在$BUFFER变量里。去掉前导空格、取第一个空格之前的部分，就是用户正在敲的命令。然后用${aliases[$first_word]}查 Zsh 内置的aliases关联数组（所有 alias 都在这里），有就拿到展开字符串：

local trimmed="${BUFFER#"${BUFFER%%[! ]*}"}" local first_word="${trimmed%% *}" local expanded="${aliases[$first_word]}"

写到 message area。zle -M <text>就是往提示符下面那行写消息的标准 API，输入下一个字符就会自然刷新。再配一个_alias_preview_last缓存，避免内容没变时的重复重绘 —— 这就是「不闪烁」的全部秘密：

zle -M " ↳ 💡: ${expanded}"

剩下两个细节：

过滤命令用${ALIAS_PREVIEW_COMMANDS[(Ie)$exp_cmd]}——(Ie)是 Zsh 数组的精确匹配下标语法，返回索引，存在则非零
避开补全菜单通过判断$LASTWIDGET是否包含complete等关键字，否则会和_complete冲突，把补全列表覆盖掉

后记

插件还很新，已知有几个地方没处理好，记录一下：

嵌套 alias 不展开。如果gco='git checkout'、gcm='gco main'，敲gcm时只会看到gco main这一层，不会再继续把gco展开成git checkout
function 形式的 alias 看不到。Zsh 里很多人会用function name() { ... }替代 alias，这种东西不在${aliases[]}里，本插件不处理
全局 alias（alias -g）没考虑。全局 alias 可以出现在命令的任意位置，按「第一个 token」匹配的策略会漏掉
截断长度暂时写死 80。之后想抽成可配置项