vscode调试powershell脚本失败主因是调试器未启动，须依次完成五步：一、安装启用microsoft官方powershell扩展；二、通过命令面板选择正确powershell运行时；三、在.vscode下创建标准launch.json配置；四、windows需设set-executionpolicy remotesigned；五、用test.ps1验证断点命中与变量查看。
VSCode 调试 PowerShell 脚本失败，90% 是因为调试器根本没启动——它默认只是把 .ps1 文件丢进终端执行，而不是进入断点调试模式。必须显式启用官方 PowerShell 扩展的调试支持，并确保会话、路径、策略三者对齐。
PowerShell 扩展没启用或不是官方版
VSCode 自身不带 PowerShell 调试能力，所有智能提示、断点、变量监视都依赖 ms-vscode.powershell 扩展。非官方插件（比如叫 “PowerShell Tools” 或带“Lite”字样的）无法提供完整调试器。
- 打开扩展面板（
Ctrl+Shift+X），搜PowerShell，只保留发布者为Microsoft的那一项 - 安装后必须点击“重新加载”按钮，否则调试功能不会激活
- 重载后打开任意
.ps1文件，右下角状态栏应显示PowerShell 7.x或Windows PowerShell 5.1，若显示Loading…或空白，说明扩展未就绪
launch.json 配置缺失或 script 字段写错
没有 .vscode/launch.json，按 F5 就是普通运行；即使有，若 script 指向错误路径，调试器会静默失败，脚本照常执行但断点不命中。
- 在项目根目录建
.vscode文件夹（注意开头是英文点），再新建launch.json -
script字段必须设为"${file}"（当前打开文件）或绝对路径（如"C:\Scripts\Deploy.ps1"），不能写相对路径如"./Deploy.ps1"（Windows 下易因工作目录错乱失效） - 确认
type是"PowerShell"，request是"launch"，其他类型（如attach）不适用于本地脚本调试
执行策略阻止脚本加载，报错“cannot be loaded because running scripts is disabled”
这不是 VSCode 的 bug，是 PowerShell 安全机制拦截了你的 .ps1 文件。即使你在终端里手动运行 .\test.ps1，也会被拦；调试时同样触发该策略。
- 在 VSCode 集成终端中执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 不要用
-Scope LocalMachine（需管理员权限，且影响全系统） - 不要用
Bypass或Unrestricted（绕过安全检查，企业环境通常被组策略覆盖） - 该命令只需运行一次，作用域仅限当前用户，不影响他人
断点灰色、变量看不到、F5 没反应
常见于 macOS/Linux 用户或 Windows 上 pwsh/powershell.exe 混用场景：VSCode 启动了调试器，但连到了错误的 PowerShell 进程，或者终端根本没切到 PowerShell。
- 按
Ctrl+`打开集成终端，右上角下拉菜单必须选中Pwsh（macOS/Linux）或PowerShell（Windows），不能是Command Prompt或zsh - 按
Ctrl+Shift+P输入PowerShell: Select PowerShell Runtime，从列表中选一个已安装的版本（如PowerShell 7.4.2），确认右下角状态栏同步更新 - 断点只能设在可执行语句行（比如
$a = 1），不能设在空行、注释行或param()块内部
最易被忽略的是：调试时脚本路径含中文或空格，会导致 launch.json 中的 ${file} 解析失败，断点直接失效——建议开发期间把脚本放在纯英文无空格路径下，比如 C:PsDev。等逻辑跑通再迁移回正式位置。
