使用PowerShell Compare-Object对比API响应与本地HTML文件异常排查

这种情况我之前也踩过坑！明明用diff工具和IDE对比都显示内容完全一致，但PowerShell的Compare-Object就是固执地认为两者不同，大概率是那些看不见的字符、编码细节或者空白格式差异在搞鬼，给你分享几个一步步排查的思路：

1. 检查不可见字符与字符码点差异 #

很多时候问题出在零宽空格、非打印字符，或者换行符/制表符这类空白上。你可以把两个内容拆成字符数组，逐个输出字符对应的Unicode码点，这样就能精准找到不一样的地方：

# 输出本地文件内容的每个字符及对应码点
$TestContent.ToCharArray() | ForEach-Object {
    [PSCustomObject]@{
        字符 = $_
        码点 = [int]$_
    }
} | Out-GridView  # 用表格视图更方便对比

# 输出API返回内容的每个字符及对应码点
$Result.ToCharArray() | ForEach-Object {
    [PSCustomObject]@{
        字符 = $_
        码点 = [int]$_
    }
} | Out-GridView

重点留意码点为13（回车CR）、10（换行LF）、65279（UTF8 BOM）这类容易被忽略的字符。

2. 严格核对编码细节 #

即使都是UTF8，带BOM和不带BOM的文件也会存在差异（本地文件可能默认保存为UTF8-BOM，而API返回的是UTF8无BOM）。你可以直接查看内容的字节开头来验证：

# 查看本地文件前10个字节
Get-Content -Path ($RepositoryLocation + "index.html") -Encoding Byte -TotalCount 10

# 查看API返回内容的前10个字节
[System.Text.Encoding]::UTF8.GetBytes($Result) | Select-Object -First 10

如果本地文件有BOM（开头字节为239 187 191），读取时可以指定无BOM编码：

$TestContent = Get-Content -Path ($RepositoryLocation + "index.html") -Raw -Encoding utf8NoBOM

3. 标准化空白后再对比 #

换行符格式（Windows的CRLF vs Unix的LF）是常见的“隐形差异”，另外首尾空白、连续空格也可能导致整个字符串被判定不同。你可以先标准化空白再对比：

# 统一换行符为LF，去掉首尾空白
$NormalizedTest = $TestContent -replace '\r\n', "`n" -replace '\r', "`n" | Trim()
$NormalizedResult = $Result -replace '\r\n', "`n" -replace '\r', "`n" | Trim()

# 对比标准化后的内容
Compare-Object -ReferenceObject $NormalizedTest -DifferenceObject $NormalizedResult

另外，你之前是对比整个字符串对象，试试逐行对比会更容易定位问题：

# 按换行符拆分后逐行对比
Compare-Object -ReferenceObject ($TestContent -Split "`n") -DifferenceObject ($Result -Split "`n")

4. 对比字节数组（终极验证） #

如果前面的方法都没找到问题，直接对比字节数组是最精准的方式——只要字节完全一致，Compare-Object就会判定相同：

$TestBytes = [System.Text.Encoding]::UTF8.GetBytes($TestContent)
$ResultBytes = [System.Text.Encoding]::UTF8.GetBytes($Result)

# 先检查长度是否一致
Write-Host "本地文件字节长度: $($TestBytes.Length)"
Write-Host "API返回字节长度: $($ResultBytes.Length)"

# 长度一致的话逐字节对比
if ($TestBytes.Length -eq $ResultBytes.Length) {
    for ($i=0; $i -lt $TestBytes.Length; $i++) {
        if ($TestBytes[$i] -ne $ResultBytes[$i]) {
            Write-Host "差异出现在字节位置 $i : 本地=$($TestBytes[$i]), API=$($ResultBytes[$i])"
            break
        }
    }
}

找到差异字节后，你可以查对应的ASCII/Unicode字符，就能知道到底是什么“隐形字符”在捣乱了。

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