命令行与文本处理 / 系统课时

处理 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 文件,读取后追加端口、修改深层字段,再以足够的深度序列化。最后重新读取目标文件并验证关键值。

powershell
$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"

预期输出:

text
服务: 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、把单元素集合当成标量,以及修改后只查看内存对象却没有重新读取落盘文件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理 JSON 数据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通