PowerShell函数传递多行字符串参数时Split方法失效排查

我编写了如下PowerShell代码：

function Main{

    $param1 = @"
aaa
bbb
ccc
"@
    Test -Param1 $param1
}

function Test {
    param (
        [Parameter(Mandatory)][string]$Param1
    )

    Write-Host $Param1
    Write-Host $Param1.GetType()
    Write-Host $Param1[0]

    Write-Host '---------------------'
    $Param1 = [regex]::split($Param1.trim(), "\r?\n");
    $Param1 = @(foreach($line in $Param1) {
        if($line -match '^\s*$') {
            continue
        }
        $line
    })

    Write-Host $Param1
    Write-Host $Param1.GetType()
    Write-Host $Param1[0]
}

Main

期望Test函数接收字符串参数，若为多行字符串则按换行符分割为数组。但运行后得到如下输出：

aaa
bbb
ccc
System.String
a
---------------------
aaa bbb ccc
System.String
a

可见[regex]::split方法未按预期分割多行字符串，明明heredoc多行字符串包含换行符，却无法分割，请问问题出在哪里？

问题原因 #

核心有两个关键问题：

1. 参数传递时换行符被自动替换：PowerShell调用函数传递参数时，会默认把多行字符串里的换行符解析为空格，导致Test函数收到的$Param1实际是"aaa bbb ccc"这样的单行字符串，自然无法用换行符分割。
2. 正则表达式转义错误：即使字符串保留了换行符，"\r?\n"作为普通字符串传入[regex]::split时，PowerShell会把\r和\n当作字面量字符处理，而非正则引擎能识别的换行符。

解决方法 #

方法1：传递参数时保留换行符 #

调用Test函数时，通过单引号包裹参数或使用--%阻止PowerShell的参数解析，强制按字面量传递多行字符串：

# 用单引号包裹参数，保留原始换行符
Test -Param1 "$param1"

# 使用--%停止参数解析（PowerShell 3.0+适用）
Test -Param1 --% $param1

方法2：修正正则表达式的转义 #

确保正则模式中的换行符被正确识别，可使用PowerShell逐字字符串或双转义反斜杠：

# 用逐字字符串定义正则模式
$Param1 = [regex]::Split($Param1.Trim(), @"\r?\n"@)

# 或对反斜杠双转义
$Param1 = [regex]::Split($Param1.Trim(), "\\r?\\n")

方法3：使用PowerShell原生-split运算符（推荐） #

PowerShell内置的-split运算符无需额外转义，能自动适配各种换行符，同时配合Where-Object过滤空行更简洁：

function Test {
    param (
        [Parameter(Mandatory)][string]$Param1
    )

    Write-Host $Param1
    Write-Host $Param1.GetType()
    Write-Host $Param1[0]

    Write-Host '---------------------'
    # 用原生-split分割并过滤空行
    $Param1 = $Param1.Trim() -split '\r?\n' | Where-Object { $_ -notmatch '^\s*$' }

    Write-Host $Param1
    Write-Host $Param1.GetType()
    Write-Host $Param1[0]
}

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