如何阻止PowerShell扁平化锯齿数组的参数？

我明白你遇到的糟心事了——PowerShell默认会把嵌套的锯齿数组（就是你定义的$RecordSchema里那种数组套数组的结构）在传递给函数参数时自动扁平化，直接把内层数组的元素拆出来逐个传递，这肯定会搞乱你字段提取的逻辑。下面给你几个实用的解决办法：

方法一：用逗号包裹数组强制保留嵌套结构 #

当你调用Map-Field函数传递schema参数时，在数组前面加个逗号，把它包装成单元素数组，告诉PowerShell“别拆这个数组，我要完整的它”：

# 调用函数时的写法
Map-Field -row $targetRow -schema ,$RecordSchema['Header']

这个逗号是关键，它会阻止PowerShell的自动展开行为，让函数接收到的是你原本定义的嵌套数组结构。

方法二：给函数参数指定明确的数组类型 #

直接在函数定义里把$schema参数的类型设为[array]或者[object[]]，明确告诉PowerShell你要接收的是一个数组对象，而不是展开后的单个元素：

function Map-Field ($row, [array]$schema) {
    $mappedRow = @{}
    foreach ($field in $schema) {
        $fieldName = $field[0]
        $fieldPosition = $field[1]
        $fieldSize = $field[2]
        # 修正拼写错误，同时适配PowerShell字符串索引从0开始的特性
        $value = $row.Substring($fieldPosition - 1, $fieldSize)
        $mappedRow[$fieldName] = $value.Trim()
    }
    return $mappedRow
}

这样定义后，不管你怎么传数组，PowerShell都会保留它的嵌套结构，不会自动扁平化。

方法三：用ValueFromRemainingArguments属性控制参数接收 #

如果你的场景更复杂，比如可能要传递多个嵌套数组，或者想严格控制参数的打包方式，可以给$schema参数加上ValueFromRemainingArguments属性，它会把所有传入的相关参数打包成一个数组，完全避免扁平化：

function Map-Field ($row, [Parameter(ValueFromRemainingArguments)]$schema) {
    $mappedRow = @{}
    foreach ($field in $schema[0]) { # 需取第一个元素，因为属性会把参数打包成数组的数组
        $fieldName = $field[0]
        $fieldPosition = $field[1]
        $fieldSize = $field[2]
        $value = $row.Substring($fieldPosition - 1, $fieldSize)
        $mappedRow[$fieldName] = $value.Trim()
    }
    return $mappedRow
}

# 调用时直接传即可，不需要额外处理
Map-Field -row $targetRow -schema $RecordSchema['Header']

补充说明 #

PowerShell的这种扁平化行为其实是“参数展开”特性——当你传递数组作为未指定类型的参数时，它会默认把数组元素逐个传递给函数。上面的方法都是围绕着明确告诉PowerShell“我要完整的数组，不要拆它”来实现的，你可以根据自己的场景选最顺手的方式。

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