若 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.。
