需安装PowerShell扩展、配置pwsh路径、启用PSScriptAnalyzer、设置launch.json调试项、创建PowerShell终端。 macOS Sequoia下路径为/opt/homebrew/bin/pwsh，支持语法高亮、智能提示、静态检查与断点调试。
如果您希望在 Visual Studio Code 中高效编写和调试 PowerShell 脚本，但尚未配置核心扩展与工作区设置，则可能面临语法高亮缺失、智能提示失效或调试无法启动等问题。以下是实现现代化 PowerShell 脚本开发环境的关键配置步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 PowerShell 扩展
PowerShell 扩展是 VSCode 识别、解析和调试 PowerShell 代码的基础组件，它提供语法着色、命令补全、脚本分析及交互式终端集成能力。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Cmd+Shift+X）。
2、在搜索框中输入 PowerShell，找到由 Microsoft 官方发布的扩展（作者显示为 Microsoft）。
3、点击“安装”按钮，安装完成后点击“重新加载”使扩展生效。
二、配置 PowerShell 运行时路径
VSCode 需明确指定所使用的 PowerShell 可执行文件位置，尤其当系统中存在多个版本（如 PowerShell 7 和 Windows PowerShell 5.1）时，此设置决定脚本实际运行环境。
1、按下 Cmd+, 打开设置界面，切换至“设置”标签页。
2、在搜索框中输入 powershell.defaultProfile，点击“在 settings.json 中编辑”链接。
3、在 JSON 文件中添加或修改以下行："powershell.powerShellDefaultVersion": "/opt/homebrew/bin/pwsh"（macOS Homebrew 安装路径）或 "powershell.powerShellDefaultVersion": "/usr/local/bin/pwsh"（macOS 手动安装路径）。
三、启用 PSScriptAnalyzer 静态检查
PSScriptAnalyzer 是 PowerShell 官方提供的代码质量分析工具，可实时检测命名不规范、未使用变量、潜在安全风险等常见问题，提升脚本健壮性。
1、确保已安装 PowerShell 扩展，该扩展默认捆绑 PSScriptAnalyzer 模块。
2、在 VSCode 设置中搜索 powershell.scriptAnalysis.enable，将其值设为 true。
3、如需自定义规则，创建项目根目录下的 PSScriptAnalyzerSettings.psd1 文件，并在设置中指定路径："powershell.scriptAnalysis.settingsPath": "./PSScriptAnalyzerSettings.psd1"。
四、配置调试启动项
调试配置使 VSCode 能以断点、变量监视、调用堆栈等方式执行 PowerShell 脚本，是开发复杂逻辑不可或缺的能力。
1、在项目根目录下新建 .vscode/launch.json 文件（若不存在该目录则先创建）。
2、在 launch.json 中填入标准 PowerShell 调试配置模板，关键字段包括：\"type\": \"PowerShell\"、\"request\": \"launch\"、\"script\": \"${file}\"。
3、保存后，打开任意 .ps1 文件，按 F5 启动调试，首次运行将自动选择 PowerShell 环境并加载会话。
五、启用 PowerShell 交互式终端
内置终端支持直接运行 PowerShell 命令、快速测试片段、查看模块输出，避免频繁切换窗口，显著提升迭代效率。
1、按下 Cmd+Shift+P 打开命令面板，输入 PowerShell: Create New Terminal 并回车。
2、终端窗口将自动启动并加载配置的默认 PowerShell 版本，提示符显示为 PS /path/to/workspace>。
3、可在该终端中直接执行 Get-Module -ListAvailable 或运行当前编辑器中的选中代码段（使用 Cmd+Shift+P → PowerShell: Run Selection）。
