如何避免PowerShell函数Add-Values传入非整数参数时的难看错误信息

好问题！当你给Add-Values传入字符串而非整数时，PowerShell默认抛出的类型转换错误确实不够友好，用户很难快速明白问题出在哪。这里有几个实用的优化方案，帮你替换成清晰易懂的错误提示，甚至提前拦截无效输入：

1. 用ValidateScript提前验证输入有效性 #

直接在参数定义阶段加入验证逻辑，不符合要求的输入会立刻抛出你自定义的友好错误，根本不会进入函数执行环节：

Function Add-Values {
    param(
        [parameter(mandatory=$true)]
        [ValidateScript({
            # 检查输入是整数类型，或者可以转换为整数的纯数字字符串
            if ($_ -is [int] -or ($_ -match '^\d+$' -and [int]::TryParse($_, [ref]$null))) {
                $true
            } else {
                throw "参数 '$_' 无效！请输入有效的整数（数字类型或纯数字字符串）。"
            }
        })]
        $val1,
        [parameter(mandatory=$true)]
        [ValidateScript({
            if ($_ -is [int] -or ($_ -match '^\d+$' -and [int]::TryParse($_, [ref]$null))) {
                $true
            } else {
                throw "参数 '$_' 无效！请输入有效的整数（数字类型或纯数字字符串）。"
            }
        })]
        $val2
    )
    # 这里可以安全地转换为int进行计算
    [int]$val1 + [int]$val2
}

这里用[int]::TryParse做了更严谨的验证，避免像"123a"这种带非数字字符的字符串被误判。

2. 在函数内部用try/catch捕获转换错误 #

如果需要更灵活的错误处理（比如记录日志、额外的修复逻辑），可以先接受任意类型的参数，再在函数内部尝试转换为整数，失败时抛出友好提示：

Function Add-Values {
    param(
        [parameter(mandatory=$true)]$val1,
        [parameter(mandatory=$true)]$val2
    )
    
    try {
        # 尝试将参数转换为整数，失败会触发catch块
        $intVal1 = [int]$val1
        $intVal2 = [int]$val2
    } catch {
        Write-Error "输入错误：两个参数都必须是整数！无效输入: '$val1' 和 '$val2'。详情：$_"
        return # 终止函数执行
    }
    
    $intVal1 + $intVal2
}

这种方式的好处是可以在catch块里做更多操作，比如输出详细的错误日志，或者给用户提供修复建议。

3. 用ValidatePattern限制输入格式（适合纯数字字符串场景） #

如果你的场景只接受纯数字组成的字符串，也可以用ValidatePattern直接限制输入格式，结合ErrorMessage自定义提示（PowerShell 5.1及以上支持）：

Function Add-Values {
    param(
        [parameter(mandatory=$true)]
        [ValidatePattern('^\d+$', ErrorMessage = "参数 '{0}' 必须是纯数字字符串，请重新输入。")]
        $val1,
        [parameter(mandatory=$true)]
        [ValidatePattern('^\d+$', ErrorMessage = "参数 '{0}' 必须是纯数字字符串，请重新输入。")]
        $val2
    )
    [int]$val1 + [int]$val2
}

这个方案更轻量化，但只适用于输入是纯数字字符串的场景，无法处理其他可以转换为int的类型（比如[double]类型的数字）。

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