在Visual Studio Code中能否调试PowerShell内联脚本块后台作业？

前提准备 #

• 已安装VSCode官方PowerShell扩展，版本不低于v2021.12.0
• 调试启动配置选择「PowerShell 交互式会话」，不要使用默认的「启动脚本」配置，默认配置的终端为非交互式，不支持Debug-Job的输入交互

操作步骤 #

1. 在需要调试的作业脚本块中，断点位置之前添加Wait-Debugger语句，和你给出的示例代码写法一致即可
2. 按F5走调试模式启动脚本，不要直接在集成终端运行脚本
3. 等待代码执行到Debug-Job -Job $Job行，先等待2-3秒，查看$Job.State的输出，正常此时状态会显示为AtBreakpoint
4. 此时VSCode调试器会自动切换到作业脚本块的执行上下文，你提前在脚本块中设置的断点会生效，也可以直接用调试控制条执行调试操作：
   • 按F10逐过程执行，F11逐语句执行，Shift+F11跳出当前作业上下文
   • 变量面板会同步展示作业进程内的所有变量值，比如示例中的$Foo会正常显示数值
5. 脚本块调试完成后，调试器会自动切回主脚本上下文，继续执行后续代码逻辑

常见问题排查 #

• 如果$Job.State一直显示Running没有变为AtBreakpoint：在$Job.State前添加一行Wait-Job $Job -Timeout 5，等待作业执行到Wait-Debugger位置后再查询状态
• 如果执行Debug-Job后没有触发断点：打开VSCode设置，搜索「PowerShell Debug: Enable attaching to child processes」，勾选该选项后重启VSCode重试
• 本方案完全支持内嵌脚本块调试，不需要将脚本块单独存储为文件

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