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 |
| zsh | gvt completion zsh > ~/.zsh/completions/_gvt |
| fish | gvt completion fish > ~/.config/fish/completions/gvt.fish |
| powershell | gvt completion powershell >> $PROFILE |
安装后输入
gvt按 Tab 即可触发补全。若gvt不在 PATH,请先软链(如ln -s $(which gvt) /usr/local/bin/gvt)。使用官方install.sh/install.ps1安装时,脚本会自动检测当前 shell 并配置补全。