如何从PowerShell的Write-Error获取完整堆栈跟踪？

默认情况下，Write-Error只会输出直接触发错误的堆栈帧，比如你给出的示例代码：

function a {
    Write-Error "错误"
}

function b {
    a
}

function c {
    b
}

c

运行后仅显示最后一层调用的错误信息：

PS C:> ._test.ps1
a : 错误
At C:_test.ps1:6 char:5

• a
  

• ~
  

  • CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
  • FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,a

要获取完整的调用堆栈，需要将Write-Error触发的非终止错误转为终止错误，这样PowerShell才会收集完整的堆栈信息。以下是两种可行方案：

方案1：针对单个Write-Error设置-ErrorAction Stop #

在调用Write-Error时添加-ErrorAction Stop参数，将其转为终止错误，再通过try/catch块捕获并访问ScriptStackTrace属性：

function a {
    Write-Error "错误" -ErrorAction Stop
}

function b {
    a
}

function c {
    b
}

try {
    c
}
catch {
    # 输出完整堆栈跟踪
    Write-Host "完整堆栈跟踪："
    Write-Host $_.ScriptStackTrace
    # 同时保留原始错误详情
    $_
}

运行后会输出包含c → b → a的完整调用链：

完整堆栈跟踪：
at a, C:_test.ps1: line 2
at b, C:_test.ps1: line 6
at c, C:_test.ps1: line 10
at , C:_test.ps1: line 14
a : 错误
At C:_test.ps1:6 char:5

• a
  

• ~
  

  • CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
  • FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,a

方案2：全局设置错误偏好 #

通过修改$ErrorActionPreference全局变量为Stop，让所有Write-Error默认触发终止错误，适合需要全局启用完整堆栈的场景：

$ErrorActionPreference = 'Stop'

function a {
    Write-Error "错误"
}

function b {
    a
}

function c {
    b
}

try {
    c
}
catch {
    $_.ScriptStackTrace
}

注意事项 #

• Write-Error默认生成非终止错误，PowerShell不会为这类错误收集完整堆栈，只有转为终止错误后才能获取ScriptStackTrace。
• 全局修改$ErrorActionPreference可能影响其他脚本的错误处理逻辑，建议在特定脚本块中使用后及时恢复原值。

内容的提问来源于stack exchange，提问作者my-so-account