如何为自定义stx命令编写zsh自动补全脚本并配置到.zshrc？

直接把以下代码片段添加到你的.zshrc文件中：

# 定义stx命令的补全函数
_comp_stx() {
    local -a subcommands
    subcommands=(
        'ls:列出相关内容'
        'clean:清理相关资源'
        'start:启动服务'
        'stop:停止服务'
    )

    _arguments \
        '*::subcommand:->subcommands'

    case "$state" in
        subcommands)
            _describe 'subcommand' subcommands
            ;;
    esac
}

# 将补全函数关联到stx命令
compdef _comp_stx stx

生效方法 #

• 添加代码后，执行source ~/.zshrc让配置立即生效，或者重启你的zsh终端。
• 现在输入stx 后按Tab键，就会自动补全ls/clean/start/stop这几个子命令，还会显示每个子命令的简短说明。

代码说明 #

• local -a subcommands：定义一个数组存储子命令和对应的描述，格式为'子命令:描述文本'。
• _arguments：zsh补全系统的核心工具，用来定义命令的参数结构，这里指定子命令为可补全项。
• _describe：用来展示子命令列表和对应的描述，让补全更直观。
• compdef：把自定义的补全函数_comp_stx绑定到stx命令上，告诉zsh用这个函数来处理stx的补全逻辑。

内容的提问来源于stack exchange，提问作者Hai Vu