需安装PowerShell扩展、设置.ps1文件语言模式为PowerShell、配置PowerShell运行时路径、Windows下设置执行策略、启用PSScriptAnalyzer检查。
如果您在 Visual Studio Code 中编写 PowerShell 脚本时遇到语法高亮异常、调试失败或命令无法识别等问题，通常是因为编辑器未正确识别脚本语言模式或缺少必要扩展支持。以下是实现规范 PowerShell 开发体验的关键步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 PowerShell 扩展
VSCode 本身不内置 PowerShell 支持，必须通过官方扩展启用完整语言服务，包括语法检查、智能提示、调试集成和代码格式化功能。
1、点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X / Cmd+Shift+X）。
2、在搜索框中输入 PowerShell，找到由 Microsoft 官方发布的扩展（ID：ms-vscode.powershell）。
3、点击“安装”按钮，安装完成后重启 VSCode。
二、设置默认语言模式为 PowerShell
新建 .ps1 文件时，VSCode 可能默认使用纯文本模式，导致无语法高亮与补全。需手动指定语言模式或配置自动关联。
1、打开一个 .ps1 文件（如 script.ps1）。
2、点击右下角显示的语言模式（例如“Plain Text”），弹出选择菜单。
3、在列表中选择 PowerShell，该文件即刻启用对应语法高亮与语义支持。
4、为永久生效，进入设置（Cmd+,），搜索 files.associations，点击“在 settings.json 中编辑”，添加条目："*.ps1": "powershell"。
三、配置 PowerShell 运行环境路径
VSCode 的 PowerShell 扩展需明确指向本地已安装的 PowerShell 可执行文件路径，尤其当系统中存在多个版本（如 PowerShell 7 与 Windows PowerShell 5.1）时，必须指定目标运行时。
1、确认已安装 PowerShell：在终端执行 pwsh --version（macOS/Linux）或 powershell -Version（Windows），记录输出的主版本号及路径。
2、打开 VSCode 命令面板（Cmd+Shift+P），输入并选择 PowerShell: Select PowerShell Runtime。
3、从列表中选择已安装的 PowerShell 版本（如 PowerShell 7.4.2），扩展将自动配置 runtimePath。
四、启用脚本执行策略（仅 Windows）
Windows 系统默认阻止本地脚本执行，即使脚本在 VSCode 中编写并调试成功，终端直接运行仍会报错“无法加载文件，因为在此系统上禁止运行脚本”。需调整执行策略以允许开发阶段运行。
1、以管理员身份启动 PowerShell 终端（非 VSCode 内置终端）。
2、执行命令：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。
3、确认操作后，当前用户即可运行本地签名或未签名的脚本，且不影响系统级安全策略。
五、使用 PSScriptAnalyzer 进行代码质量检查
PSScriptAnalyzer 是 PowerShell 官方静态分析工具，可检测命名规范、冗余代码、潜在错误等，VSCode 扩展默认集成该功能，但需确保其规则启用并符合团队标准。
1、在 VSCode 设置中搜索 powershell.scriptAnalysis.enable，确认值为 true。
2、创建或编辑项目根目录下的 PSScriptAnalyzerSettings.psd1 文件，定义自定义规则，例如禁用 PSUseApprovedVerbs 或启用 PSAvoidUsingWriteHost。
3、保存后，VSCode 将实时在问题面板中显示分析结果，并在编辑器内标出警告或错误行。
