通过

在 macOS 上安装 PowerShell

PowerShell 7 或更高版本需要 macOS 13 及更高版本。 PowerShell 的 GitHub 发布 页上提供了所有包。 安装包以后，从终端运行 pwsh。 在安装之前，请检查 受支持的版本列表。

较新版本的 PowerShell 7 取代了现有 PowerShell 7 版本。 PowerShell 的预览版可以与其他版本的 PowerShell 并行安装。 较新的预览版本将替换现有的以前的预览版本。如果需要与以前的版本并行运行 PowerShell 7.5，请使用 二进制存档 方法重新安装以前的版本。

注释

本文中的安装命令适用于 PowerShell 的最新稳定版本。 若要安装其他版本的 PowerShell，请调整命令以匹配所需的版本。 以下链接将带您到 GitHub 上每个版本的最新发布页面。

在“发布”页的“资产”部分中可以找到每个包的下载链接。 由于“资产”部分可能处于折叠状态，因此可能需要单击展开它。

安装 PowerShell 的最新稳定版本

可采用多种方法在 macOS 上安装 PowerShell。 选择下列方法之一：

使用 Homebrew 进行安装

如果未找到 brew 命令，则需要按照说明安装 Homebrew。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

首先安装 brew，然后安装 PowerShell。

以下命令将安装 PowerShell 的最新稳定版本：

brew install --cask powershell

验证安装是否正常工作：

pwsh

PowerShell 新版本发布后，更新 Homebrew 公式并升级 PowerShell：

brew update
brew upgrade powershell

注释

可以从 PowerShell （pwsh） 会话中调用上述命令，但随后必须重启 PowerShell 会话才能完成升级并刷新中显示的 $PSVersionTable值。

安装 PowerShell 的最新预览版

以下命令安装 PowerShell 的最新预览版：

brew install powershell/tap/powershell-preview

运行以下命令以启动 PowerShell 预览版：

pwsh-preview

发布 PowerShell 的新预览版时，请更新 Homebrew 的公式并升级到 PowerShell 的最新预览版本：

brew update
brew upgrade powershell-preview

注释

可以从 PowerShell （pwsh） 会话中调用上述命令，但随后必须重启 PowerShell 会话才能完成升级并刷新中显示的 $PSVersionTable值。

安装 PowerShell 的最新 LTS 版本

以下命令安装 PowerShell 的最新 LTS 版本：

brew install powershell/tap/powershell-lts

验证安装：

pwsh-lts

发布 PowerShell 的新 LTS 版本后，运行以下命令以更新 Homebrew 的公式并升级到 PowerShell 的最新 LTS 版本：

brew update
brew upgrade powershell-lts

注释

在更新到较新版本的 PowerShell 时，请使用与初始安装相同的方法，即 cask 或 tap。 如果使用其他方法，则打开新的 pwsh 会话将继续使用旧版 PowerShell。

如果决定使用不同的方法，可通过多种方式使用 Homebrew 链接方法更正问题。

直接下载后安装该软件包

从版本 7.2 开始，PowerShell 支持 Apple M 系列基于 Arm 的处理器。 将安装包从 发布 页下载到 Mac。 指向当前版本的链接包括：

可通过两种方法使用直接下载方法安装 PowerShell。

使用 Finder

使用 Finder 安装 PowerShell：

  1. 打开 查找器

  2. 找到下载的包

  3. 双击该文件

    安装包时将收到以下错误消息：

    “powershell-7.5.4-osx-arm64.pkg”未打开

    Apple 无法验证“powershell-7.5.4-osx-arm64.pkg”不受恶意软件的影响，这些恶意软件可能会损害 Mac 或损害隐私。

  4. 选择“ 完成 ”按钮关闭提示。

此错误消息来自 macOS 的 Gatekeeper 功能。 有关详细信息，请参阅 Mac 上的安全打开应用 - Apple 支持。

尝试打开包后，请执行以下步骤：

  1. 打开 系统设置。
  2. 选择 “隐私和安全 ”，然后向下滚动到 “安全 ”部分。
  3. 选择“无论如何打开”按钮以确认安装 PowerShell。
  4. 当警告提示再次出现时，请选择“ 仍然打开”。
  5. 输入用户名和密码以允许安装继续。

使用终端

若要从命令行安装 PowerShell 包，必须绕过 Gatekeeper 检查。 使用以下方法之一安装包：

  • 运行命令 installer，并加上 allowUntrusted 标志：

    sudo installer -allowUntrusted -pkg ./Downloads/powershell-7.5.4-osx-arm64.pkg -target /

  • 或者像平常一样安装包，运行以下命令之一：

    • 运行 sudo xattr -rd com.apple.quarantine ./Downloads/powershell-7.5.4-osx-arm64.pkg。
    • 如果您正在使用 PowerShell，请使用 Unblock-File cmdlet。 包括 .pkg 文件的完整路径。

作为 .NET 全局工具安装

如果你已安装 .NET Core SDK，则可以轻松地安装 PowerShell 作为 .NET 全局工具。

dotnet tool install --global PowerShell

dotnet 工具安装程序将 ~/.dotnet/tools 添加到 PATH 环境变量中。 不过，当前运行的 shell 没有更新后的 PATH。 通过键入 pwsh从新 shell 启动 PowerShell。

二进制存档

已对 macOS 平台提供 PowerShell 二进制 tar.gz 存档，以启用高级部署方案。 使用此方法进行安装时，还必须手动安装任何依赖项。

注释

你可以使用此方法安装任何版本的 PowerShell，包括最新版本：

在 macOS 上安装二进制存档

将安装包从 发布 页下载到 Mac。 指向当前版本的链接包括：

使用以下命令从二进制存档安装 PowerShell。 更改下载 URL 以匹配要安装的版本。

# Download the powershell '.tar.gz' archive
curl -L -o /tmp/powershell.tar.gz https://github.com/PowerShell/PowerShell/releases/download/v7.5.4/powershell-7.5.4-osx-arm64.tar.gz

# Create the target folder where powershell is placed
sudo mkdir -p /usr/local/microsoft/powershell/7

# Expand powershell to the target folder
sudo tar zxf /tmp/powershell.tar.gz -C /usr/local/microsoft/powershell/7

# Set execute permissions
sudo chmod +x /usr/local/microsoft/powershell/7/pwsh

# Create the symbolic link that points to pwsh
sudo ln -s /usr/local/microsoft/powershell/7/pwsh /usr/local/bin/pwsh

卸载 PowerShell

如果使用 Homebrew 安装 PowerShell，请使用以下命令进行卸载：

brew uninstall --cask powershell

如果通过直接下载安装 PowerShell，则必须手动删除 PowerShell：

sudo rm -rf /usr/local/bin/pwsh /usr/local/microsoft/powershell

若要删除额外的 PowerShell 路径，请参阅本文档中的 路径 部分，并使用 删除路径 sudo rm。

注释

如果使用 Homebrew 进行安装，则不需要此过程。

路径

  • $PSHOME 为 /usr/local/microsoft/powershell/7。
    • macOS 安装包会创建一个符号链接 /usr/local/bin/pwsh，该链接指向 pwsh 位置中的 $PSHOME。
  • 用户配置文件是从 ~/.config/powershell/profile.ps1 中读取的
  • 默认配置文件是从 $PSHOME/profile.ps1 中读取的
  • 用户模块是从 ~/.local/share/powershell/Modules 中读取的
  • 共享模块是从 /usr/local/share/powershell/Modules 中读取的
  • 默认模块是从 $PSHOME/Modules 中读取的
  • PSReadLine 的历史记录保存到 ~/.local/share/powershell/PSReadLine/ConsoleHost_history.txt

PowerShell 采用 macOS 上的 XDG Base Directory 规范。

支持的版本

Microsoft 在 PowerShell 到达支持终止日期或 macOS 版本到达支持终止日期之前仍然支持 PowerShell。

  • macOS 26 （Tahoe） x64 和 Arm64
  • macOS 15 （Sequoia） x64 和 Arm64
  • macOS 14 (Sonoma) x64 和 Arm64

Apple 确定 macOS 的支持生命周期。 有关详细信息，请参阅以下内容：

安装支持

Microsoft 支持本文档中的安装方法。 其他源可能还有其他安装方法。 虽然这些工具和方法可能正常工作，但Microsoft不支持这些方法。

其他资源

  • Last updated on