为何将批量搜索替换命令放入PowerShell函数后失效？

问题场景 #

• test.txt文件内容为：hi
• 编写的PowerShell脚本中定义了searchAndReplace函数，调用时使用searchAndReplace($value1, $value2)，运行后未完成字符串替换
• 但直接在Shell中执行硬编码参数的替换命令，却能正常生效

核心原因：PowerShell函数调用语法错误 #

你踩了PowerShell函数调用的典型坑：PowerShell不使用C风格的函数名(参数1, 参数2)语法传递多个参数。

你的调用写法searchAndReplace($value1, $value2)，在PowerShell里实际是把$value1和$value2打包成一个数组对象，整体传递给了函数的第一个参数$search，而第二个参数$replace则是默认的$null。

因为$replace是$null，且$search是数组类型，String.Replace方法无法匹配目标字符串hi，所以完全没有替换效果。

正确的函数调用方式 #

PowerShell中传递多个参数要用空格分隔，不需要括号和逗号：

searchAndReplace $value1 $value2

验证问题的小方法 #

可以在函数里添加一行输出参数类型的代码，直观确认问题：

function searchAndReplace {
    param (
        $search, $replace
    )
        
    Write-Host "`$search类型：" $search.GetType().Name
    Write-Host "`$replace值：" $replace
    # 原替换逻辑...
}

执行原错误调用后，会看到$search是Object[]类型，$replace是$null，直接证实参数传递错误。

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