PowerShell调试问题可通过五步解决：一、安装启用官方PowerShell扩展；二、配置正确的PowerShell解释器路径；三、设置正确的launch.json调试配置；四、启用PowerShell控制台集成；五、验证执行策略与脚本编码。
如果您在 Visual Studio Code 中使用 PowerShell 进行脚本开发，但遇到断点不命中、变量无法查看或调试会话意外终止等问题，则可能是由于 PowerShell 扩展配置不当、运行环境不匹配或调试启动设置错误所致。以下是解决此问题的步骤：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、安装并启用 PowerShell 扩展
VSCode 本身不内置 PowerShell 支持，必须通过官方扩展提供语法高亮、智能提示和调试能力。该扩展由 Microsoft 维护，需确保其处于启用状态并为最新版本。
1、打开 VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。
2、在搜索框中输入 PowerShell，找到由 Microsoft 发布的官方扩展（ID：ms-vscode.powershell）。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
4、重启 VSCode，新建一个 .ps1 文件，确认右下角状态栏显示 PowerShell 且语言模式已自动切换。
二、配置 PowerShell 解释器路径
VSCode 需明确知道使用哪个 PowerShell 可执行文件进行运行与调试。若系统中存在多个 PowerShell 版本（如 PowerShell 7 和 Windows PowerShell 5.1），未指定路径将导致调试失败或行为异常。
1、按下 Cmd+Shift+P（macOS）调出命令面板，输入并选择 PowerShell: Select PowerShell Runtime。
2、从列表中选择已安装的 PowerShell 版本，例如 PowerShell 7.4.0（路径通常为 /opt/homebrew/bin/pwsh）。
3、确认状态栏右侧显示所选版本号，且终端中运行 $PSVersionTable.PSVersion 输出一致。
三、设置 launch.json 调试配置
VSCode 依赖 .vscode/launch.json 文件定义调试会话的行为。缺少该文件或配置项错误会导致“无法启动调试”或“找不到脚本”等提示。
1、在项目根目录下创建 .vscode 文件夹（若不存在）。
2、在 .vscode 目录中新建 launch.json 文件，内容如下：
3、粘贴以下 JSON 配置（确保 type 字段为 PowerShell，request 字段为 launch，script 字段指向当前工作区中的 .ps1 文件路径）：
4、保存文件后，打开待调试的 .ps1 文件，在任意行左侧边距单击设置断点，按 F5 启动调试。
四、启用 PowerShell 控制台集成
调试过程中需实时观察命令输出、交互式变量检查及错误堆栈，集成终端必须正确关联 PowerShell 运行时，否则调试控制台可能静默退出或无法响应命令。
1、按下 Cmd+Shift+P，输入并选择 Terminal: Select Default Profile。
2、从下拉列表中选择 PowerShell（对应 pwsh 或 powershell 可执行文件）。
3、关闭所有终端窗口，按下 Cmd+J 打开集成终端，确认提示符以 PS 开头且 $IsCoreCLR 返回 True（表示运行于 PowerShell Core）。
五、验证调试符号与脚本执行策略
PowerShell 的执行策略（ExecutionPolicy）会阻止未签名脚本运行，而调试器依赖脚本的完整符号信息；若策略限制过严或脚本被压缩/混淆，调试器将无法解析断点位置。
1、在集成终端中执行 Get-ExecutionPolicy -List，确认 Process 级别策略为 Bypass 或 Unrestricted。
2、若需临时提升策略，运行 Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process。
3、检查脚本头部无不可见 Unicode 字符或 BOM 编码，使用 VSCode 右下角编码指示器确认文件编码为 UTF-8（不含 BOM）。
