PowerShell 安装失败？跨平台安装与验证 5 步避坑完整指南

PowerShell 安装失败？跨平台安装与验证 5 步避坑完整指南

【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell

在 Linux 上装完 PowerShell 敲pwsh，却只得到一句"未找到命令"；Windows 上装完打开新终端，依然进不了 PowerShell。别急，照下面 5 步走，10 分钟内装好 PowerShell 并验证可用。

动手前的 4 项自检

• 你的 CPU 架构是什么？x86_64、arm64还是armv7？安装包必须和架构一一对应，这是装失败的头号原因
• 目标机器能否访问外部网络？官方安装脚本会从网上拉取最新发行包
• 你是否拥有管理员权限？Linux 上安装需要sudo，Windows 上建议用管理员终端
• 你是否已经装了旧版 PowerShell？升级前最好确认旧版本的安装方式，官方建议用同一种方式更新

核心操作：3 步装好并验证

步骤一：克隆仓库，拿到官方安装脚本

这一步做什么：把安装脚本本地化，后续所有操作都在仓库目录里进行，避免直接执行来路不明的远程脚本。

具体怎么做：

# 克隆 PowerShell 官方仓库（Windows 用 pwsh，Linux/macOS 用 bash） git clone https://gitcode.com/GitHub_Trending/po/PowerShell cd PowerShell

做对了长什么样：当前目录出现README.md、tools/等目录，且tools/下能看到install-powershell.ps1和install-powershell.sh两个文件。

步骤二：一条命令完成安装

这一步做什么：用官方自适应脚本自动检测系统架构和发行版，下载并安装匹配的 PowerShell 包。

具体怎么做：

# Linux/macOS：执行官方安装脚本，自动匹配架构 ./tools/install-powershell.sh

# Windows（管理员 PowerShell）：安装并写入 PATH Set-ExecutionPolicy Bypass -Scope Process -Force .\tools\install-powershell.ps1 -AddToPath

做对了长什么样：脚本输出中能看到下载和安装完成的提示，没有红色错误信息；Windows 上装完提示已更新环境变量。

步骤三：打开新终端，验证安装结果

这一步做什么：确认pwsh能被找到、版本号正常、命令可执行。

具体怎么做：

# 打开一个全新的终端，逐条执行 pwsh pwsh -Command '$PSVersionTable.PSVersion'

做对了长什么样：

• pwsh能进入 PowerShell 提示符（PS /路径>样式），不再报"未找到命令"
• $PSVersionTable正常输出版本表，其中OS、Platform字段与你的系统一致
• 此时输入Get-Command等内置命令（cmdlet，PowerShell 里执行任务的小程序）有返回

装不上时的 3 条备用路线

按"先易后难"排列，挑第一条能跑通的即可：

1. 手动下载对应架构的压缩包，解压即用。适用于网络能连上发行源、但不想让脚本自动决策的机器。到 PowerShell 官方发行页选与你架构一致的tar.gz（Linux）或zip/MSI（Windows）解压到任意目录，直接把可执行文件路径加入 PATH。

2. 用 Docker 容器运行。适用于不想污染系统环境、或架构与宿主机不同的场景：docker pull mcr.microsoft.com/powershell后docker run -it --rm mcr.microsoft.com/powershell pwsh。

3. 从源码编译。适用于预编译包不支持你的架构（如特定 ARM 板卡）。先跑Start-PSBootstrap装工具链，再用Start-PSBuild按目标架构编译，完整步骤见 docs/building/linux.md。

小结

装好 PowerShell 的关键就三件事：架构选对、脚本跑通、新终端验证。下一步建议继续了解 更新日志 里的新功能，或阅读 docs/ 下跨平台安装文档，把安装方式固化成你自己的标准流程。

关键文件参考：

• tools/install-powershell.ps1：Windows/macOS/Linux 通用安装脚本（PowerShell 版）
• tools/install-powershell.sh：Linux/macOS 安装脚本（bash 入口）
• docs/building/linux.md：从源码构建 PowerShell 的完整流程
• global.json：编译所需的 .NET SDK 版本锁定

【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell