VSCode与PowerShell脚本开发和调试

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，内容为：

Motiff

Motiff是由猿辅导旗下的一款界面设计工具，定位为“AI时代设计工具”

148

查看详情

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。

以上就是VSCode与PowerShell脚本开发和调试的详细内容，更多请关注php中文网其它相关文章！