PowerShell中ForEach-Object的Catch块无法枚举哈希表键值对

枚举哈希表时会遇到一个特殊行为：用ForEach-Object结合Try/Catch/Finally块处理时，Catch块无法获取哈希表的键值对，但Try和Finally块可以正常访问；而使用foreach循环时，所有块都能正常获取键值对。

示例1：ForEach-Object的异常输出（Catch块无键值对） #

# Catch块无法获取键值对示例
$ht = @{
    1 = 'one'
    2 = 'two'
    3 = 'three'
}

$ht.GetEnumerator() | ForEach-Object {
    Try {
        "Try block: $($_.Name) - $($_.Value)" ; Start-Something
    }
    Catch {
        "Catch block: $($_.Name) - $($_.Value)"
    }
    Finally {
        "Finally block: $($_.Name) - $($_.Value)"
    }
}

输出结果 #

Try block: 3 - three
Catch block:  - 
Finally block: 3 - three
Try block: 2 - two
Catch block:  - 
Finally block: 2 - two
Try block: 1 - one
Catch block:  - 
Finally block: 1 - one

示例2：foreach循环的正常输出（所有块均可访问键值对） #

# 所有块均可正常获取键值对示例
foreach ($h in $ht.GetEnumerator() ) {
    Try {
        "Try block: $($h.Name) - $($h.Value)" ; Start-Something
    }
    Catch {
        "Catch block: $($h.Name) - $($h.Value)"
    }
    Finally {
        "Finally block: $($h.Name) - $($h.Value)"
    }
}

输出结果 #

Try block: 3 - three
Catch block: 3 - three
Finally block: 3 - three
Try block: 2 - two
Catch block: 2 - two
Finally block: 2 - two
Try block: 1 - one
Catch block: 1 - one
Finally block: 1 - one

行为差异的核心原因 #

• ForEach-Object中的$_作用域变化：在ForEach-Object的脚本块里，Try块中的$_指代管道传来的哈希表枚举项（DictionaryEntry对象）。但当Catch块触发时，PowerShell会自动将$_重设为当前的错误记录对象（ErrorRecord），直接覆盖了原来的哈希表项引用，因此无法再通过$_获取键值对。而Finally块的执行上下文不会被错误记录干扰，仍保留原脚本块的$_，所以能正常访问。
• foreach循环的变量作用域稳定：foreach循环中使用自定义变量$h接收枚举项，这个变量在整个迭代周期的作用域内保持不变，不会被Catch块的错误记录覆盖，因此所有块都能通过$h正常访问哈希表的键值对。

验证技巧 #

可以在Catch块中输出$_的类型，直观看到它的变化：

Catch {
    "Catch block: 当前$_的类型是 $($_.GetType().Name)"
}

执行后会发现输出的类型是ErrorRecord，而非预期的DictionaryEntry。

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