ZSH补全使用compadd -U移除参数问题及自定义vs函数补全需求

看起来你在为自定义的文件打开函数vs配置补全时，遇到了多匹配文件的补全问题——当输入example<TAB>时，本该出现两个候选文件（./example.sh和./custom/example.sh），但当前补全没有正确处理这种多匹配场景。下面是具体的分析和解决方案：

问题分析 #

你的补全脚本目前可能只做了单文件匹配或者仅遍历当前目录，导致遇到同名文件（不同路径）时无法列出所有候选，或者直接跳转到第一个匹配项。而direct<TAB>能成功补全是因为只有custom/directory.sh这一个匹配项，没有冲突。

解决方案：编写通用的补全脚本 #

我们可以为vs函数编写一个shell补全函数，它会递归遍历当前目录下所有匹配输入前缀的文件，然后列出所有候选供选择。

步骤1：定义补全函数 #

在你的.bashrc或.zshrc（根据你使用的shell）中添加以下补全函数：

_vs_completion() {
    local cur=${COMP_WORDS[COMP_CWORD]}
    # 递归查找所有匹配当前输入前缀的文件，排除目录和隐藏文件
    local matches=$(find . -type f -name "${cur}*" | grep -v '/\.' | sort)
    # 将匹配结果转换为补全候选
    COMPREPLY=($(compgen -W "$matches" -- "$cur"))
}

步骤2：绑定补全函数到vs #

添加完补全函数后，用complete命令把它和你的vs函数绑定：

complete -F _vs_completion vs

关键细节说明 #

• find . -type f -name "${cur}*"：递归查找当前目录下所有以输入前缀开头的文件（-type f确保只匹配文件，不包含目录）
• grep -v '/\.'：排除隐藏文件和隐藏目录下的文件（如果不需要排除这部分内容，可以直接删掉这个管道命令）
• sort：对匹配结果排序，让补全候选的展示更整洁有序
• compgen -W "$matches" -- "$cur"：把找到的文件列表转换成shell补全能识别的候选格式

测试效果 #

重新加载你的shell配置（比如执行source ~/.bashrc）后，输入vs example<TAB>，应该会显示两个候选：

example.sh    custom/example.sh

你可以通过按两次TAB来切换选择，或者输入更多字符缩小匹配范围（比如vs custom/ex<TAB>会直接补全到custom/example.sh）。

适配你的vs函数逻辑 #

如果你的vs函数是优先打开当前目录的文件，补全时也可以调整排序规则，让当前目录的文件排在前面：

# 修改find命令，先查找当前目录，再查找子目录
local matches=$(find . -maxdepth 1 -type f -name "${cur}*" | grep -v '/\.'; find . -mindepth 2 -type f -name "${cur}*" | grep -v '/\.') | sort

这样补全时example.sh会排在custom/example.sh前面，和你的函数逻辑更匹配。

内容的提问来源于stack exchange，提问作者GitCommit Victor B.