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

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。

# linux # vscode # js # json # windows # macbook # mac # ai # macos # win # select # microsoft # 运行环境 # 加载 # 也会 # 多个 # 您在 # 按下 # 报错 # 而非 # 则可 # 若不

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】