powershell怎么读取json文件

PowerShell 读取 JSON 文件完全指南

在 PowerShell 中处理 JSON 文件是一项常见任务，无论是配置管理、数据交换还是 API 交互，JSON 都扮演着重要角色，本文将详细介绍如何使用 PowerShell 读取和解析 JSON 文件，包括基本方法、高级技巧以及常见问题的解决方案。

使用 Get-Content 和 ConvertFrom-Json 基本方法

最直接的方式是使用 Get-Content cmdlet 读取文件内容，然后通过 ConvertFrom-Json 将 JSON 字符串转换为 PowerShell 对象。

# 读取 JSON 文件并转换为 PowerShell 对象
$jsonObject = Get-Content -Path "C:\path\to\your\file.json" -Raw | ConvertFrom-Json
# 访问 JSON 中的属性
Write-Output $jsonObject.propertyName

说明：

• -Raw 参数确保文件内容作为单个字符串读取，而不是按行分割
• ConvertFrom-Json 将 JSON 字符串转换为 PowerShell 对象（通常是 PSCustomObject）

使用 Get-Content 的 -LiteralPath 参数

当文件路径包含特殊字符或需要精确匹配路径时，推荐使用 -LiteralPath：

$jsonObject = Get-Content -LiteralPath "C:\path\with[brackets]\file.json" -Raw | ConvertFrom-Json

处理大型 JSON 文件

对于大型 JSON 文件，可以使用 Get-Content 的 -ReadCount 参数逐块处理：

# 逐行读取并处理（适用于每行是一个独立 JSON 对象的情况）
Get-Content -Path "largefile.json" -ReadCount 1000 | ForEach-Object {
    $chunk = $_ | ConvertFrom-Json
    # 处理每个块中的数据
}

使用 Invoke-RestMethod 读取 JSON

JSON 文件可以通过 HTTP 访问（如 API 响应），可以使用 Invoke-RestMethod：

# 从 URL 读取 JSON
$jsonObject = Invoke-RestMethod -Uri "https://api.example.com/data.json"
# 本地文件也可以通过 file:// 协议访问（但通常不推荐，Get-Content 更高效）
$jsonObject = Invoke-RestMethod -Uri "file:///C:/path/to/file.json"

错误处理

读取 JSON 文件时可能会遇到各种错误,建议添加错误处理：

try {
    $jsonObject = Get-Content -Path "config.json" -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop
    # 处理 JSON 数据
}
catch {
    Write-Error "无法读取或解析 JSON 文件: $_"
    # 可以选择退出或使用默认值
    exit 1
}

处理 JSON 数组

JSON 文件包含数组结构,处理方式略有不同：

$jsonArray = Get-Content -Path "data.json" -Raw | ConvertFrom-Json
# 遍历数组
foreach ($item in $jsonArray) {
    Write-Output $item.property
}
# 或者使用 ForEach-Object
$jsonArray | ForEach-Object {
    Write-Output $_.property
}

深度嵌套的 JSON 结构

对于深度嵌套的 JSON，可以使用点表示法或 Select-Object 访问嵌套属性：

$jsonObject = Get-Content -Path "nested.json" -Raw | ConvertFrom-Json
# 点表示法访问嵌套属性
$value = $jsonObject.level1.level2.property
# 使用 Select-Object
$value = $jsonObject | Select-Object -ExpandProperty level1 | Select-Object -ExpandProperty level2 | Select-Object -ExpandProperty property

将 JSON 转换为哈希表

如果需要将 JSON 转换为哈希表而不是 PSCustomObject：

$jsonObject = Get-Content -Path "config.json" -Raw | ConvertFrom-Json
$hashtable = @{}
$jsonObject.PSObject.Properties | ForEach-Object {
    $hashtable[$_.Name] = $_.Value
}

使用第三方模块

对于更复杂的 JSON 处理，可以考虑使用第三方模块如 PowershellCommunity.Json：

# 安装模块 (如果需要)
Install-Module -Name PowershellCommunity.Json -Scope CurrentUser
# 使用模块功能
Import-Module PowershellCommunity.Json
$jsonObject = Get-Json -Path "complex.json"

常见问题与解决方案

问题 1：JSON 文件包含注释

• 标准 JSON 不支持注释，如果需要处理带注释的 JSON，可以先预处理文件移除注释

问题 2：文件编码问题

• 使用 -Encoding 参数指定编码：

  $jsonObject = Get-Content -Path "file.json" -Raw -Encoding UTF8 | ConvertFrom-Json

问题 3：日期时间处理

• JSON 中的日期时间通常需要手动转换：

  $date = [datetime]::Parse($jsonObject.dateString)

PowerShell 提供了多种读取和解析 JSON 文件的方法，从简单的 Get-Content + ConvertFrom-Json 组合到更高级的错误处理和嵌套结构访问，选择哪种方法取决于你的具体需求、文件大小和复杂度，这些技巧将使你在处理配置文件、API 响应和现代数据格式时更加得心应手。