PowerShell返回哈希表数组时单元素返回异常是否符合预期？

现象是否符合预期？ #

完全符合预期，这是PowerShell的核心行为之一——自动解包单元素集合。

和C#严格遵循返回类型不同，PowerShell的函数返回逻辑基于输出流：当你返回一个集合（比如数组）时，PowerShell会把集合中的元素逐个输出到流中。如果集合只有一个元素，PowerShell会直接返回这个元素本身，而非包裹它的数组。这就是为什么$one的类型变成了Hashtable而非数组，自然无法用数字索引[0]访问（因为Hashtable的索引是键名，不是位置序号）。

解决方案 #

除了你采用的封装哈希表的方法，还有更直接的方式强制返回数组类型：

1. 用逗号运算符强制保留数组

在返回的数组前添加一个逗号，PowerShell会将其视为包含数组的嵌套集合，拆包外层后就能保留原数组结构：

function GetArrayOfHashtable
{
    param([string] $name, [int]$count)
    $result = @()
    for ($i = 0; $i -lt $count; $i++) {
        $h = @{
            name = $name
            id=$i+1
        }
        $result += $h
    }
    return ,$result  # 逗号强制返回数组类型
}

$one = GetArrayOfHashtable "one" 1
Write-Host $one.gettype()  # 'System.Object[]'
Write-Host $one[0].name $one[0].id  # 'one 1'

2. 强制类型转换为数组

直接将结果转为[array]类型，PowerShell会保留数组结构：

return [array]$result

3. 用泛型列表构建结果（更高效）

@() +=的方式每次都会创建新数组，性能较差。用泛型列表可以避免这个问题，最后转成数组返回：

function GetArrayOfHashtable
{
    param([string] $name, [int]$count)
    $result = [System.Collections.Generic.List[hashtable]]::new()
    for ($i = 0; $i -lt $count; $i++) {
        $h = @{
            name = $name
            id=$i+1
        }
        $result.Add($h)
    }
    return [array]$result  # 转成数组返回，也可直接返回List类型（如果业务允许）
}

你的封装哈希表方法

这种方法同样有效，通过将数组放入哈希表的属性中，PowerShell不会拆包哈希表内部的数组，适合需要返回结构化数据的场景。

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