fzf-tab
使用fzf替换zsh的默认补全选择菜单!
目录
安装
[!重要]
- 确保已安装fzf
- fzf-tab需要在
compinit
之后加载,但要在会包装小部件的插件之前加载,如zsh-autosuggestions或fast-syntax-highlighting- 补全应该在
compinit
之前配置,正如zsh-completions手动安装指南中所述。
手动安装
首先,克隆此仓库。
git clone https://github.com/Aloxaf/fzf-tab ~/somewhere
然后在您的~/.zshrc
中添加以下行。
autoload -U compinit; compinit
source ~/somewhere/fzf-tab.plugin.zsh
Antigen
antigen bundle Aloxaf/fzf-tab
Zinit
zinit light Aloxaf/fzf-tab
Oh-My-Zsh
将此仓库克隆到您的自定义目录,然后将fzf-tab
添加到您的插件列表中。
git clone https://github.com/Aloxaf/fzf-tab ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/fzf-tab
Prezto
将此仓库克隆到您的contrib目录,然后在.zpreztorc
中将fzf-tab
添加到您的模块列表中。
git clone https://github.com/Aloxaf/fzf-tab $ZPREZTODIR/contrib/fzf-tab
使用
像往常一样按Tab键即可~
可用的按键绑定:
-
Ctrl+
Space :选择多个结果,可通过fzf-bindings
标签配置 -
F1/F2:在组之间切换,可通过
switch-group
标签配置 -
/:触发连续补全(在补全深层路径时很有用),可通过
continuous-trigger
标签配置
可用的命令:
-
disable-fzf-tab
:禁用fzf-tab并回退到compsys -
enable-fzf-tab
:启用fzf-tab -
toggle-fzf-tab
:切换fzf-tab的状态。这也是一个zle小部件。
配置
常见的配置如下:
# 在补全`git checkout`时禁用排序
zstyle ':completion:*:git-checkout:*' sort false
# 设置描述格式以启用组支持
# 注意:这里不要使用转义序列,fzf-tab会忽略它们
zstyle ':completion:*:descriptions' format '[%d]'
# 设置list-colors以启用文件名着色
zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS}
# 强制zsh不显示补全菜单,这允许fzf-tab捕获无歧义的前缀
zstyle ':completion:*' menu no
# 在补全cd时使用eza预览目录内容
zstyle ':fzf-tab:complete:cd:*' fzf-preview 'eza -1 --color=always $realpath'
# 使用`<`和`>`切换组
zstyle ':fzf-tab:*' switch-group '<' '>'
Tmux
如果您使用的是tmux >= 3.2,我们提供了一个脚本ftb-tmux-popup
来充分利用其"弹出"功能。
zstyle ':fzf-tab:*' fzf-command ftb-tmux-popup
顺便说一下,您也可以在fzf-tab之外使用这个脚本。
ls | ftb-tmux-popup
更多信息,请参见Wiki#Configuration。
二进制模块
默认情况下,如果您设置了list-colors
标签,fzf-tab会使用zsh-ls-colors来解析和应用ZLS_COLORS。
然而,这是一个纯zsh脚本,如果您有太多文件需要着色,它会变得很慢。
fzf-tab附带了一个二进制模块来加速这个过程。您可以使用build-fzf-tab-module
构建它,然后它会自动启用。
与其他插件的区别
fzf-tab不执行"补全",它只是向您展示默认补全系统的结果。
因此它可以在任何地方工作(变量、函数名、目录栈、单词内补全等)。 而且您对默认补全系统的大部分配置仍然有效。
与其他插件的兼容性
一些插件可能也会将"^I"绑定到它们的自定义小部件,比如fzf/shell/completion.zsh或ohmyzsh/lib/completion.zsh。
默认情况下,fzf-tab会调用之前绑定到"^I"的小部件来获取补全列表。所以在大多数情况下没有问题,除非fzf-tab在一个未正确处理先前绑定的插件之前初始化。
因此,如果您发现fzf-tab无法正常工作,请确保它是最后一个绑定"^I"的插件(如果您不明白我的意思,只需将它放到插件列表的末尾)。
相关项目
- https://github.com/lincheney/fzf-tab-completion (zsh、bash和GNU readline应用程序的fzf标签补全)