如何防止PowerShell中ConvertFrom-Json在嵌套数组仅含1个元素时折叠数组

这个问题其实是PowerShell的ConvertFrom-Json cmdlet的一个常见“陷阱”——当JSON数组只有单个元素时，它会自动将数组展开为标量值（也就是单个对象），而不是保留数组类型。这就导致了你看到的差异：

• 当rows有2行时，它被解析成一个数组的数组，.rows[0]自然指向第一行的完整数组；
• 当rows只有1行时，它被解析成单个数组（也就是那一行的数据），此时.rows[0]就变成了访问这个数组的第一个元素，也就是ChangePassword。

下面是几种可靠的解决方法，覆盖不同PowerShell版本的需求：

方法1：使用-AsHashtable参数（PowerShell 6+） #

如果你使用的是PowerShell 6或更高版本，最简单的方法是在ConvertFrom-Json时加上-AsHashtable参数。这个参数会将JSON转换为哈希表结构，并且严格保留数组的原始结构，即使只有一个元素也不会展开：

# 处理单元素JSON文件
$file1Data = Get-Content file1.json | ConvertFrom-Json -AsHashtable
$file1Data.tables.rows[0]  # 输出：ChangePassword CN 1 2022-07-19T11:51:52.8430729Z 2022-07-19T11:51:52.8430729Z

# 处理多元素JSON文件
$file2Data = Get-Content file2.json | ConvertFrom-Json -AsHashtable
$file2Data.tables.rows[0]  # 输出和上面一致，行为完全统一

方法2：强制转换为数组（兼容PowerShell 5.1及更早版本） #

如果需要兼容旧版PowerShell（比如Windows默认的5.1），可以用PowerShell的数组强制符@()，把rows属性的结果强制转为数组。这样不管原始数据是单元素还是多元素，都会被当作数组处理：

# 处理单元素文件
$file1Data = Get-Content file1.json | ConvertFrom-Json
$rows = @($file1Data.tables.rows)
$rows[0]  # 正确返回完整的第一行数据

# 处理多元素文件
$file2Data = Get-Content file2.json | ConvertFrom-Json
$rows = @($file2Data.tables.rows)
$rows[0]  # 同样返回第一行数据，行为一致

方法3：使用-AsArray参数（PowerShell 7.3+） #

PowerShell 7.3及以上版本给Select-Object -ExpandProperty添加了-AsArray参数，专门用来解决这种“单元素被展开”的问题。你可以用它来提取rows并确保结果是数组：

# 处理单元素文件
$file1Data = Get-Content file1.json | ConvertFrom-Json
$rows = $file1Data.tables | Select-Object -ExpandProperty rows -AsArray
$rows[0]  # 正确返回第一行完整数据

# 处理多元素文件同理
$file2Data = Get-Content file2.json | ConvertFrom-Json
$rows = $file2Data.tables | Select-Object -ExpandProperty rows -AsArray
$rows[0]  # 行为统一

这些方法都能保证你无论面对单行还是多行的rows数据，都能通过[0]索引可靠地获取第一行的完整内容。

内容的提问来源于stack exchange，提问作者Tom Pažourek