fzf-tab

使用fzf替换zsh的默认补全选择菜单！

目录

• fzf-tab
• 安装
  • 手动安装
  • Antigen
  • Zinit
  • Oh-My-Zsh
  • Prezto
• 使用
  • 配置
  • Tmux
  • 二进制模块
• 与其他插件的区别
• 与其他插件的兼容性
• 相关项目

安装

[!重要]

1. 确保已安装fzf
2. fzf-tab需要在compinit之后加载，但要在会包装小部件的插件之前加载，如zsh-autosuggestions或fast-syntax-highlighting
3. 补全应该在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

使用

像往常一样按<kbd>Tab</kbd>键即可~

可用的按键绑定：

• <kbd>Ctrl</kdb>+<kdb>Space</kbd>：选择多个结果，可通过fzf-bindings标签配置

• <kbd>F1</kbd>/<kbd>F2</kbd>：在组之间切换，可通过switch-group标签配置

• <kbd>/</kbd>：触发连续补全（在补全深层路径时很有用），可通过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标签补全）