在PowerShell父脚本调用子脚本时，让Write-Error显示真实错误位置

问题场景 #

现有以下脚本：

Parent.ps1 #

& "./Child.ps1"

Child.ps1 #

Write-Host "some log"
Write-Error "non terminating error log"
Write-Host "something else"

运行Parent.ps1时，Write-Error的错误位置被关联到父脚本的调用行（D:\pwtest\Parent.ps1:1），而非子脚本内的实际行，需要让错误日志显示子脚本的正确行号。

解决方案 #

方法1：使用点源（Dot-Sourcing）执行子脚本 #

将父脚本中的调用操作符&替换为点.，把子脚本的内容加载到当前作用域执行，错误会直接关联到子脚本内的对应行。

修改后的Parent.ps1：

. "./Child.ps1"

运行后输出：

some log
Write-Error: D:\pwtest\Child.ps1:2
Line |
   2 |  Write-Error "non terminating error log"
     |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | non terminating error log
something else

方法2：在子脚本中使用$PSCmdlet.WriteError() #

给子脚本添加[CmdletBinding()]声明，使用$PSCmdlet对象的WriteError()方法输出错误，即使通过&调用也能保留正确的错误位置信息。

修改后的Child.ps1：

[CmdletBinding()]
param()

Write-Host "some log"
$errorRecord = [System.Management.Automation.ErrorRecord]::new(
    [Exception]"non terminating error log",
    "CustomError",
    [System.Management.Automation.ErrorCategory]::NotSpecified,
    $null
)
$PSCmdlet.WriteError($errorRecord)
Write-Host "something else"

运行原Parent.ps1（仍用&调用）后，输出的错误位置会指向子脚本的对应行：

some log
Write-Error: D:\pwtest\Child.ps1:8
Line |
   8 |  $PSCmdlet.WriteError($errorRecord)
     |  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     | non terminating error log
something else

原因说明 #

• 调用操作符&会创建独立的执行上下文，默认Write-Error生成的错误记录会将父脚本的调用点标记为错误源。
• 点源执行会让子脚本在当前作用域运行，错误直接关联子脚本内的执行行。
• $PSCmdlet.WriteError()会生成包含完整调用栈信息的错误记录，能精准定位到子脚本内的错误触发位置，不受调用方式影响。

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