如何在Fish Shell中实现PowerShell脚本参数补全？寻求更优方案

好问题！想要在fish里复刻PowerShell自带的参数制表符补全体验，不管是针对特定脚本还是通用适配任意.ps1文件，确实有几种实用思路，咱们一步步拆解：

一、你提出的预生成补全语句方案（适配特定脚本） #

你想到的自动扫描.ps1文件、提取Param块生成fish补全命令的思路完全可行，而且针对高频使用的特定脚本非常精准。比如你举的示例生成的这几行命令，就能完美实现对应补全效果：

complete -c myscript.ps1 -f
complete -c myscript.ps1 -o param1
complete -c myscript.ps1 -o param2 -a "nc6 nc12 nc24"
complete -c myscript.ps1 -F -o param3

这个方案的优势是补全响应快，没有额外的解析开销。如果要优化，可以写个小脚本定期扫描你的常用PowerShell脚本目录，自动生成补全文件并存放在~/.config/fish/completions/下，fish会自动加载这些补全规则。唯一需要注意的是，当脚本的Param块修改后，要重新生成补全语句。

二、更优的动态适配方案（适配任意PowerShell脚本） #

如果你想实现无需预配置、自动适配任意.ps1脚本的补全，核心思路是让fish直接调用pwsh实时解析脚本的参数信息，而不是提前生成补全规则。具体可以通过fish的动态补全功能实现：

1. 编写动态解析的fish函数 #

创建一个fish函数，让它调用pwsh解析目标脚本的Param块，提取参数名、验证规则等信息，然后返回对应的补全规则：

function pwsh_dynamic_completions
    # 获取当前命令行中要补全的脚本路径
    set target_script (commandline -ct | string match '*.ps1')
    if test -z "$target_script"
        return
    end

    # 调用pwsh解析脚本的Param块
    pwsh -NoProfile -Command "
        try {
            $scriptContent = Get-Content '$target_script' -Raw -ErrorAction Stop
            $ast = [System.Management.Automation.Language.Parser]::ParseInput($scriptContent, [ref]$null, [ref]$null)
            $paramBlock = $ast.ParamBlock
            if ($paramBlock) {
                foreach ($param in $paramBlock.Parameters) {
                    $paramName = '--' + $param.Name.VariablePath.UserPath
                    $output = $paramName

                    # 处理ValidateSet属性，提取可选值
                    $validateSet = $param.Attributes | Where-Object { $_ -is [System.Management.Automation.ValidateSetAttribute] }
                    if ($validateSet) {
                        $output += ':' + ($validateSet.ValidValues -join ' ')
                    }

                    # 处理ValidateScript（比如匹配Test-Path Leaf的情况）
                    $validateScript = $param.Attributes | Where-Object { $_ -is [System.Management.Automation.ValidateScriptAttribute] }
                    if ($validateScript -and $validateScript.ScriptBlock.ToString() -match 'Test-Path.*Leaf') {
                        $output += ':file'
                    }

                    echo $output
                }
            }
        } catch {
            # 解析失败时不输出任何内容，避免干扰补全
        }
    " | while read line
        set parts (string split ':' $line)
        set param_name (string trim -- $parts[1])
        if test (count $parts) -eq 2
            if test $parts[2] = 'file'
                # 补全文件路径
                complete -c pwsh -a "$param_name" -F
            else
                # 补全固定选项
                complete -c pwsh -a "$param_name" -a "$parts[2]"
            end
        else
            # 普通参数，仅补全参数名
            complete -c pwsh -a "$param_name"
        end
    end
end

2. 绑定补全函数到pwsh命令 #

把上面的函数绑定到pwsh的补全规则中，这样当你输入pwsh ./myscript.ps1 --时，fish会自动调用这个函数获取补全内容：

# 先让fish补全.ps1文件路径
complete -c pwsh -a '*.ps1' -f
# 绑定动态补全函数
complete -c pwsh -F pwsh_dynamic_completions

如果你的系统已经配置了.ps1文件可以直接执行（比如通过shebang或者fish的文件关联），可以把补全规则绑定到文件本身，替换上面的-c pwsh为-c myscript.ps1或者用通配符适配所有.ps1文件。

三、有没有现成的实现？ #

目前fish官方补全库中没有专门针对PowerShell脚本的通用补全，但社区里有一些爱好者分享的类似脚本，核心思路和上面的动态解析方案一致。你可以基于上面的代码自己调整，比如增加对更多PowerShell参数属性的支持（比如位置参数、动态参数等），或者优化pwsh的解析逻辑。

内容的提问来源于stack exchange，提问作者Chris F Carroll