zsh-completions

名称、版本与用途

  • 名称:zsh-completions
  • 当前版本:Git commit fd4a16961f71
  • 目录:~/.oh-my-zsh/custom/plugins/zsh-completions
  • 用途:补充 zsh 自带补全之外的第三方命令补全定义。

当前安装与更新

当前是 Git 克隆:

git -C ~/.oh-my-zsh/custom/plugins/zsh-completions pull --ff-only
exec zsh

配置文件

.zshrc 在 Oh My Zsh 初始化前把下列目录加入 fpath:

~/.oh-my-zsh/custom/plugins/zsh-completions/src
~/.zfunc

~/.zfunc 当前另有 _fd 和 _rg。

zsh 启动集成

是,但不是通过 plugins=(...) 加载。它通过 fpath 参与随后由 Oh My Zsh 执行的 compinit。

基本功能与推荐用法

print -l $fpath                    # 查看补全搜索路径
whence -w _fd _rg                 # 检查补全函数
type compinit                     # 确认 compinit 可用
rm -f ~/.zcompdump*               # 仅在补全缓存确实损坏时清理
exec zsh

最后两条会重建补全缓存,不应作为日常操作。新增自定义补全时,把 _command 文件放入 ~/.zfunc,并确保该目录在 compinit 前进入 fpath。

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素含义
git -C DIR在 DIR 中运行 Git,无需先 cd。
git pull --ff-only只允许快进更新,避免自动产生合并提交。
print -lzsh 内建 print:每个参数输出一行。
whence -w NAME显示 NAME 属于哪类命令或函数。
type NAME说明 NAME 的解析结果。
rm -f FILE删除文件;不存在时不报错。
exec zsh用新的 zsh 替换当前 shell 进程。

官方资料