如何使用Visual Studio Code调试远程计算机上的Invoke-Command脚本？

问题情况 #

你的代码结构如下：

LocalCode # L1
$result = Invoke-Command -Session $remoteComputer -ScriptBlock { # L2
    RemoteCode # L3
} # L4
LocalCode $result # L5

其中$remoteComputer是正常可用的远程会话。在VSCode中，第1、5行的断点能正常触发，但第3行的断点完全没有反应，单步执行第2行时会直接跳过整个脚本块。已知Set-PSBreakpoint不支持远程调试，且你希望在本地VSCode完成调试、不修改代码。

无需修改代码的调试办法 #

办法1：切换到远程PowerShell会话调试 #

1. 打开VSCode的PowerShell终端，若还未建立远程会话，先执行：

   $remoteComputer = New-PSSession -ComputerName 你的远程计算机名
   Enter-PSSession $remoteComputer
   

2. 此时终端已切换为远程机器的执行环境，你可以直接将完整脚本复制到终端执行，也可以在VSCode中打开脚本后，通过右下角状态栏的PowerShell会话选择器，把执行上下文切换到该远程会话。
3. 现在就能直接在第3行设置断点，调试流程和本地脚本完全一致，所有断点都会正常触发。

办法2：复用已有远程会话调试 #

如果已经存在可用的$remoteComputer会话，无需重新建立：

1. 在本地PowerShell终端中执行：

   Enter-PSSession $remoteComputer
   

2. 切换到远程会话后，VSCode中打开的脚本会以远程机器为执行环境，设置的断点会直接作用于远程执行的代码块，包括第3行的内容。

原理说明 #

VSCode的PowerShell调试器依赖当前执行上下文。本地执行Invoke-Command时，远程脚本块是在远程机器上独立运行的，本地调试器无法附着到远程进程。而通过Enter-PSSession进入远程会话后，VSCode的调试上下文会切换到远程机器，脚本的执行和调试都在远程环境中进行，断点自然能正常工作。

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