Skip to content

gvt completion — 生成并安装 shell 命令补全

生成 bash / zsh / fish / powershell 的命令补全脚本,风格类似 docker completion。补全内容直接读取 CLI 运行时命令树,后续新增或删除命令会自动生效,无需手动维护。

用法

bash
gvt completion                  # 自动推断 $SHELL 并安装
gvt completion bash            # 安装 bash 补全
gvt completion zsh --output    # 仅输出脚本到 stdout,不安装
gvt completion bash > file     # 仅输出脚本到文件

参数

参数简写说明
--install-i强制安装(即使 stdout 被重定向)
--output-o仅输出脚本到 stdout,不安装

安装行为

  • 交互终端中默认会自动安装到对应 shell 的持久化配置文件(如 ~/.bashrc),无需手动执行命令;
  • 将 stdout 重定向(如 gvt completion bash > file)时,则只输出纯脚本;
  • --output / -o 始终只输出脚本、绝不写入磁盘;--install / -i 即使在重定向时也强制安装。

各 shell 持久化路径

Shell持久化命令
bash`gvt completion bash
zshgvt completion zsh > ~/.zsh/completions/_gvt
fishgvt completion fish > ~/.config/fish/completions/gvt.fish
powershellgvt completion powershell >> $PROFILE

安装后输入 gvt 按 Tab 即可触发补全。若 gvt 不在 PATH,请先软链(如 ln -s $(which gvt) /usr/local/bin/gvt)。使用官方 install.sh / install.ps1 安装时,脚本会自动检测当前 shell 并配置补全。

基于 MIT 协议开源