VSCode调试PowerShell脚本失败需依次完成五步：一、安装启用Microsoft官方PowerShell扩展；二、通过命令面板选择正确PowerShell运行时（如pwsh 7.4.2）；三、在.vscode下创建标准launch.json配置；四、Windows需设Set-ExecutionPolicy RemoteSigned；五、用test.ps1验证断点命中与变量查看。
如果您在使用 vscode 编辑和调试 powershell 脚本时遇到断点不触发、终端无响应或脚本执行结果异常等问题，则可能是由于扩展配置、运行环境或调试设置不匹配所致。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 PowerShell 扩展
VSCode 本身不内置 PowerShell 支持，需通过官方扩展提供语法高亮、智能提示与调试能力。该扩展由 Microsoft 维护，是 PowerShell 脚本开发的基础依赖。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 ⇧⌘X）。
2、在搜索框中输入 PowerShell，找到名称为 PowerShell、发布者为 Microsoft 的扩展。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
二、配置默认 PowerShell 解释器路径
VSCode 需明确调用哪个 PowerShell 可执行文件（如 pwsh 或 powershell），尤其在 macOS 或 Linux 上存在多个版本时，错误路径会导致调试启动失败或命令无法识别。
1、按下 ⇧⌘P 打开命令面板，输入并选择 PowerShell: Select PowerShell Runtime。
2、从下拉列表中选择已安装的 PowerShell 版本，例如 PowerShell 7.4.2 (pwsh)。
3、确认状态栏右下角显示所选运行时名称，且无红色警告图标。
三、创建 launch.json 调试配置
launch.json 定义了 VSCode 如何启动和附加到 PowerShell 进程，缺失或配置错误将导致 F5 调试无法启动或直接执行而非进入断点。
1、在项目根目录下新建文件夹 .vscode（若不存在）。
2、在该文件夹内创建文件 launch.json，内容为：
3、粘贴以下 JSON 配置：
{
"version": "0.2.0",
"configurations": [
{
"type": "PowerShell",
"request": "launch",
"name": "PowerShell Launch Script",
"script": "${file}",
"args": [],
"cwd": "${fileDirname}"
}
]
}
四、启用脚本执行策略（Windows 环境专属）
PowerShell 默认阻止本地脚本执行，即使在 VSCode 中调试也会被策略拦截，报错信息通常包含 execution policy 或 cannot be loaded because running scripts is disabled。
1、以管理员身份启动 Windows Terminal 或 PowerShell。
2、运行命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
3、输入 Y 确认更改，确保当前用户策略已更新。
五、验证调试断点行为
断点未命中常因脚本未被正确加载、解释器未挂载调试器或代码位于非执行路径。需通过最小可复现脚本确认基础调试链路是否通畅。
1、新建文件 test.ps1，内容为：
$a = 42
Write-Host "Value is $a"
$a += 1
Write-Host "Now it's $a"
2、在第二行左侧空白处点击设置断点（出现红点）。
3、按 F5 启动调试，确认控制台输出暂停在断点处，且变量窗口可查看 $a 值为 42。
