在 macOS 上配置 VS Code 使用 PowerShell(适配 Homebrew 安装)

发布于:2025-03-26 ⋅ 阅读:(32) ⋅ 点赞:(0)

在 macOS 上配置 VS Code 使用 PowerShell(适配 Homebrew 安装)

PowerShell 是跨平台的自动化脚本语言,非常适合管理系统配置和批量任务。而 VS Code 则是开发者首选的轻量级编辑器。本文将手把手教你如何在 macOS 上通过 Homebrew 安装 PowerShell 并配置 VS Code 正确识别它。


🧰 环境信息

  • 操作系统:macOS (Apple Silicon)
  • PowerShell 安装方式:Homebrew
  • VS Code 插件:PowerShell Extension(Microsoft 出品)

🍺 安装 PowerShell

推荐通过 Homebrew 安装 PowerShell:

brew install powershell/tap/powershell

安装完成后,确认 PowerShell 可执行文件路径:

command -v pwsh

通常会是:

/opt/homebrew/bin/pwsh

❌ VS Code 无法识别 PowerShell?

安装好 PowerShell 后,在 VS Code 中打开 .ps1 脚本时,可能会出现如下报错:

“Unable to find PowerShell! Do you have it installed?”

在这里插入图片描述

这是因为 VS Code 默认不会去 /opt/homebrew/bin/ 下面查找 pwsh


✅ 正确配置 VS Code 支持 PowerShell(手动方式)

  1. 打开 VS Code 命令面板(快捷键 Cmd + Shift + P
  2. 输入并选择 Preferences: Open User Settings (JSON)
  3. 添加以下配置:
"powershell.powerShellAdditionalExePaths": {
  "Homebrew PowerShell": "/opt/homebrew/bin/pwsh"
},
"powershell.powerShellDefaultVersion": "Homebrew PowerShell"

完整示例(保留你已有的设置):

{
  "redhat.telemetry.enabled": true,
  "powershell.powerShellAdditionalExePaths": {
    "Homebrew PowerShell": "/opt/homebrew/bin/pwsh"
  },
  "powershell.powerShellDefaultVersion": "Homebrew PowerShell"
}

保存后重启 VS Code,右下角应该可以看到 PowerShell 已加载。

在这里插入图片描述
在这里插入图片描述


🌟 推荐增强设置(可选)

"powershell.integratedConsole.showOnStartup": false,
"powershell.scriptAnalysis.enable": true,
"powershell.codeFormatting.autoCorrectAliases": true

解释:

  • showOnStartup: 不自动弹出 PowerShell 控制台
  • scriptAnalysis.enable: 启用代码规范检查
  • autoCorrectAliases: 自动将别名如 ls 替换为 Get-ChildItem

❓ Parallels Desktop 相关配置是啥?

如果你看到以下类似配置:

"parallels-desktop.git.path": "/usr/bin/git",
"parallels-desktop.brew.path": "/opt/homebrew/bin/brew"

说明你安装了 Parallels 的 VS Code 插件,用于与虚拟机环境交互。这些配置不会影响 PowerShell 的使用。


🧹 清理建议(可选)

如果你不再使用 Parallels 插件,可以手动移除相关配置项,不影响其他功能。


✅ 总结

配置 VS Code 正确识别 Homebrew 安装的 PowerShell,只需 3 步:

  1. 安装 PowerShell:brew install --cask powershell
  2. 添加路径配置到 settings.json
  3. 安装并启用 PowerShell 插件(来自 Microsoft)

至此,你的 macOS + VS Code + PowerShell 开发环境就准备好了!可以尽情享受跨平台脚本的快乐 🚀