若VSCode中PowerShell脚本执行异常、断点不命中或IntelliSense失效，需依次执行五步：一、安装启用官方PowerShell扩展；二、将集成终端设为pwsh；三、配置.launch.json调试设置；四、禁用冲突扩展并重启PowerShell会话；五、安装PSScriptAnalyzer启用静态检查。
如果您在 Visual Studio Code 中编写和调试 PowerShell 脚本时遇到执行异常、断点不命中或 IntelliSense 失效等问题，则可能是由于扩展配置、会话环境或调试设置未正确协同。以下是针对该场景的多种实操方案：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装并启用 PowerShell 扩展
PowerShell 脚本的语法高亮、代码补全与调试能力依赖于官方 PowerShell 扩展，必须确保其已安装且处于激活状态。
1、打开 VSCode，点击左侧活动栏的扩展图标（方块拼图形状）。
2、在搜索框中输入 PowerShell，找到由 Microsoft 发布的官方扩展（作者显示为 Microsoft，ID 为 ms-vscode.powershell）。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
4、重启 VSCode，新建一个以 .ps1 为后缀的文件，确认编辑器右下角语言模式显示为 PowerShell。
二、配置 PowerShell 集成终端为默认会话
VSCode 默认终端可能调用的是系统 shell（如 zsh 或 bash），而非 PowerShell，导致脚本运行环境与调试环境不一致。
1、按下 Cmd+Shift+P（macOS）调出命令面板。
2、输入并选择 Terminal: Select Default Profile。
3、在弹出列表中选择 PowerShell (pwsh)（确保已安装 PowerShell 7+）。
4、关闭所有终端窗口，重新打开终端，确认提示符前缀显示为 PS 字样。
三、启用调试配置并设置 launch.json
VSCode 的调试功能需通过 launch.json 显式声明 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}"
}
]
}
4、保存文件，打开任意 .ps1 文件，在代码行号左侧单击设置断点，按 F5 启动调试。
四、禁用冲突扩展并重置语言服务
部分第三方扩展（如某些 Shell 或 Markdown 工具）可能劫持 .ps1 文件关联或干扰 PowerShell 语言服务器通信，造成补全延迟或调试中断。
1、进入扩展视图，依次禁用名称含 shell、markdown、code-runner 的非必要扩展。
2、按下 Cmd+Shift+P，输入 PowerShell: Restart Current Session 并执行。
3、观察右下角状态栏是否出现 PowerShell session is ready 提示。
五、使用 PSScriptAnalyzer 实施静态检查
PowerShell 脚本易因大小写混用、未声明变量或冗余分号引发隐性错误，PSScriptAnalyzer 可在保存时自动标出潜在问题。
1、在终端中运行命令：Install-Module -Name PSScriptAnalyzer -Force -Scope CurrentUser。
2、打开 VSCode 设置（Cmd+,），搜索 powershell.scriptAnalysis.enable，勾选启用项。
3、新建 test.ps1，输入 $a = 1; Write-Host $b，保存后查看波浪线下划线提示 The variable '$b' is not assigned.。
