若VSCode中PowerShell调试异常，需依次完成五步：一、安装并重载Microsoft官方PowerShell扩展；二、配置launch.json中type为PowerShell且含program、args、cwd字段；三、通过集成终端切换至pwsh并验证版本；四、在.ps1文件设断点后按F5启动调试；五、在settings.json中显式指定pwsh绝对路径并重启VSCode。
如果您在VSCode中编写PowerShell脚本时遇到断点不触发、变量无法查看或调试控制台无响应等问题，则可能是由于PowerShell扩展配置不当、会话未正确启动或调试环境未就绪。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用PowerShell扩展
VSCode本身不内置PowerShell调试支持，必须通过官方扩展提供语言服务和调试器集成。该扩展由Microsoft维护，提供语法高亮、智能感知、断点调试等核心功能。
1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
2、在搜索框中输入PowerShell，找到名称为“PowerShell”的扩展（发布者为Microsoft）。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
二、配置PowerShell调试启动项
调试会话依赖于launch.json中的配置，它定义了脚本路径、运行参数及PowerShell可执行文件位置。缺少或错误的配置将导致调试器无法启动目标会话。
1、在VSCode中打开包含.ps1文件的文件夹（确保已初始化工作区）。
2、按Ctrl+Shift+P调出命令面板，输入并选择Debug: Open launch.json。
3、若提示选择环境，选择PowerShell；若已存在配置，确认其中含有type字段值为PowerShell的配置项。
4、检查configurations数组内是否包含类似以下结构的条目：
"program": "${file}", "args": [], "cwd": "${fileDirname}"。
三、使用集成终端启动PowerShell会话
VSCode的PowerShell调试器需连接到一个活跃的PowerShell进程。若终端未运行PowerShell（例如当前是bash或zsh），调试器将无法注入调试上下文。
1、按下Ctrl+`打开集成终端。
2、在终端右上角下拉菜单中，选择PowerShell（若未显示，需先确保PowerShell已安装并被系统识别）。
系统优势： 全DIV+CSS模板，多浏览器适应，完美兼容IE6-IE8，以及Firefox Opera 等符合标准的浏览器，模板样式集中在一个CSS文件中，内容与样式完全分离，方便网站设计人员开发模板与管理。系统较为安全，以设计防注入，敏感字符屏蔽。新闻，产品，单页独立关键字设计，提高搜索引擎收录。 调试环境必须为IIS 后台账户密码：admin功能介绍：基本信息设置：网站名称，联系人等信息
3、输入pwsh --version验证终端已切换至PowerShell 7+运行时。
4、关闭所有其他终端标签页，仅保留一个PowerShell终端处于激活状态。
四、设置并触发断点调试
断点是调试的核心机制，但其生效依赖于脚本以调试模式运行而非直接执行。直接点击“运行”按钮或使用F5前必须确保当前编辑器聚焦在.ps1文件上且launch.json配置可用。
1、在.ps1文件中，点击行号左侧灰色区域设置断点，出现红色圆点即表示已激活。
2、确保编辑器焦点位于该.ps1文件标签页内，而非终端、输出面板或其他文件。
3、按F5启动调试，或点击左侧活动栏的调试图标，再点击绿色三角形启动按钮。
4、若弹出环境选择提示，选择PowerShell Launch Script配置项。
五、检查PowerShell可执行路径配置
当VSCode无法定位pwsh或powershell可执行文件时，调试器将报错“Cannot find PowerShell executable”。此问题常见于macOS或Linux系统，因PowerShell未加入PATH或路径被自定义覆盖。
1、在终端中运行which pwsh，记录返回的完整路径（如/usr/local/bin/pwsh）。
2、打开VSCode设置（Ctrl+,），搜索powershell.powerShellDefaultVersion。
3、点击“在settings.json中编辑”，添加如下键值对：
"powershell.powerShellDefaultVersion": "/usr/local/bin/pwsh"。
4、重启VSCode使路径配置生效。
