在 vscode 中调试 PowerShell 脚本需安装官方 PowerShell 扩展、确保本地安装 PowerShell 7.x 或windows PowerShell、通过 F5 启动调试并设断点，遇执行策略问题运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 即可。
在 VSCode 中编写和调试 PowerShell 脚本，关键在于正确配置 PowerShell 扩展、选择合适的运行环境（如 windows PowerShell 或 PowerShell Core），并掌握基础调试操作。不需要额外安装复杂 工具，但几个细节容易忽略，直接影响体验。
安装并启用 PowerShell 扩展
VSCode 本身不内置 PowerShell 支持，必须通过官方扩展补全语法高亮、智能提示、调试入口等功能。
- 打开扩展视图（Ctrl+Shift+X 或 Cmd+Shift+X），搜索“PowerShell”—— 认准 microsoft 官方发布者（图标为蓝色 PS 字样）
- 点击安装，安装完成后重启 VSCode（部分版本需手动重载窗口）
- 打开一个 .ps1 文件，底部状态栏应显示当前 PowerShell 运行时（如“PowerShell 7.4”或“Windows PowerShell 5.1”）；若未显示，说明扩展未激活或未检测到已安装的 PowerShell 实例
确保系统中已安装可用的 PowerShell 版本
扩展依赖本地 PowerShell 可执行文件。VSCode 默认优先查找 PowerShell Core（pwsh），其次才是 Windows PowerShell（powershell.exe）。
- 在终端中运行 pwsh –version 或 powershell -Command “$PSVersionTable.PSVersion” 确认是否已安装
- 推荐安装 PowerShell 7.x（跨平台、持续更新、性能更好），可从 GitHub 发布页 下载安装包
- 如果只装了 Windows 自带的 PowerShell 5.1，扩展也能用，但不支持新语法（如管道链式操作
|>）和部分调试特性
运行与调试脚本的常用方式
不必总靠写完再右键“运行”，VSCode 提供多种快捷路径，适配不同场景。
- 快速执行：打开 .ps1 文件，按 F5 启动调试（首次会自动生成
.vscode/launch.json）；或按 F8 在集成终端中直接运行当前选中代码块（无调试） - 调试配置：F5 首次运行后，可在
.vscode/launch.json中修改"script"和"args"字段，传参、指定脚本路径更灵活 - 断点调试：在代码行号左侧单击设断点（红点），F5 启动后会在该行暂停；鼠标悬停变量可查看值，调试控制台支持执行任意 PowerShell 命令（比如
$myVar | Get-Member） - 注意终端类型：默认使用“集成 PowerShell 终端”，如需切换（例如测试兼容性），可通过 Ctrl+Shift+P →“PowerShell: Show session Menu” 切换运行时
常见问题速查
遇到“无法加载脚本”“ExecutionPolicy 被拒绝”等提示，基本都和策略限制有关，不是扩展问题。
- 在 VSCode 集成终端中运行：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（仅对当前用户生效，无需管理员权限）
- 若调试时卡在“Starting PowerShell……”：检查 杀毒软件 是否拦截 pwsh.exe，或尝试在 launch.json 中添加
"createTemporaryIntegratedconsole": true - 中文路径或参数乱码？确保 VSCode 文件 编码 为 UTF-8（右下角点击 编码 → 选择“Save with Encoding”→ UTF-8），并在脚本开头加
[Console]::InputEncoding = [Console]::OutputEncoding = [System.Text.UTF8Encoding]::new()
基本上就这些。配置一次，后续新建脚本就能直接调试，比 ISE 更轻快，也比纯命令行更可控。
