命令行与文本处理 / 系统课时
处理 JSON 数据
处理 JSON 数据
JSON 能表达嵌套对象和数组,但错误的读取方式或序列化深度会悄悄破坏结构。本课将完成一次 JSON 文件的读取、修改、写回和重新解析,并用关键字段验证结果,而不是只观察文本外观。
学习目标
- 使用
ConvertFrom-Json访问嵌套对象和数组 - 使用
ConvertTo-Json控制序列化深度并写回文件 - 通过重新解析验证结构、数组边界和关键值
JSON 与 PowerShell 对象的对应关系
JSON 对象通常转换为 PSCustomObject,属性可用点号访问;JSON 数组转换为可索引的对象集合;true、false 和 null 分别对应布尔值与 $null。数字类型会根据值进行推断,因此涉及精确金额或严格接口契约时,仍应显式检查或转换。
嵌套访问遵循对象层级,例如 service.limits.memoryMb;数组元素使用索引访问,例如 instances[0].id。处理可能只有一个元素的结果时,用 @(...) 包裹后再读取 Count,可以稳定得到数组语义。
完成嵌套数据的往返处理
下面的脚本创建 JSON 文件,读取后追加端口、修改深层字段,再以足够的深度序列化。最后重新读取目标文件并验证关键值。
$sourcePath = Join-Path $PWD 'service-source.json'
$targetPath = Join-Path $PWD 'service-result.json'
@'
{
"service": {
"name": "api",
"ports": [8080, 8443],
"limits": {
"cpu": 2,
"memoryMb": 1024
}
},
"enabled": true,
"instances": [
{ "id": "a1", "zone": "zone-a" },
{ "id": "b2", "zone": "zone-b" }
]
}
'@ | Set-Content -Path $sourcePath -Encoding utf8
$config = Get-Content -Path $sourcePath -Raw |
ConvertFrom-Json
# 显式构造新数组,避免单元素结果造成结构歧义
$config.service.ports = @($config.service.ports) + 9000
$config.service.limits.memoryMb = 2048
$serialized = $config | ConvertTo-Json -Depth 5
$serialized | Set-Content -Path $targetPath -Encoding utf8
$verified = Get-Content -Path $targetPath -Raw |
ConvertFrom-Json
$isValid = $verified.enabled -and
$verified.service.ports[-1] -eq 9000 -and
$verified.service.limits.memoryMb -eq 2048
"服务: $($verified.service.name)"
"端口: $($verified.service.ports -join ',')"
"实例数: $(@($verified.instances).Count)"
"深层内存限制: $($verified.service.limits.memoryMb)"
"往返验证: $isValid"预期输出:
服务: api
端口: 8080,8443,9000
实例数: 2
深层内存限制: 2048
往返验证: True脚本会在当前目录生成源文件和结果文件。文件缩进可能因 PowerShell 版本略有差异,但重新解析后的结构和值应保持一致。
深度、数组与验证边界
ConvertTo-Json 的默认深度较小。对象层级超过限制时,深层对象可能被转换为字符串表示,并出现深度警告,最终文本仍可能是合法 JSON,却已经丢失原结构。应根据实际模型设置 -Depth,并只给出覆盖当前结构所需的合理值。本例使用 -Depth 5,验证时重新访问最深层字段。
根节点是数组且必须保留数组边界时,可以使用 ConvertFrom-Json -NoEnumerate。对于对象属性中的数组,使用 @(...) 可稳定处理零个、一个或多个元素。JSON 的 null 会转换为 $null,序列化时也会保留为空值,不应误当成空字符串。
读取文件时应使用 Get-Content -Raw,把完整 JSON 作为一个字符串交给解析器。不要直接比较原始文本,因为缩进、空格和属性顺序可能变化;应比较关键字段、数组长度和最深层值。只判断语法时可使用 Test-Json,验证业务结构时仍需重新解析。
当键名包含空格、连字符,或存在大小写敏感的重复键时,点号访问可能不方便,可考虑 ConvertFrom-Json -AsHashtable 后使用键索引。常见失败包括遗漏 -Depth、把单元素集合当成标量,以及修改后只查看内存对象却没有重新读取落盘文件。