4 步搞定 PowerShell 安装报错：从验证架构到成功运行的完整指南
【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell
在 Linux 上跑 PowerShell 安装脚本，装到一半弹出报错，或者装完执行pwsh提示命令不存在？这篇指南带你用官方脚本完成 PowerShell 安装，并逐个排查最常见的失败原因。
开工前：把环境对齐
开始安装前，先确认 3 件事：
- 架构是否匹配：执行
uname -m查看处理器架构，x86_64对应 x64 包，aarch64对应 ARM64 包，下错包是最常见的失败原因 - 系统是否在支持列表内：PowerShell 支持 Windows、macOS 及主流 Linux 发行版，老旧系统请参考官方文档
- 权限：Linux/macOS 安装需要
sudo权限；仓库内 tools/install-powershell.sh 会自动做 sudo 可用性检查
为什么会出现这个问题
大部分"安装失败"其实是架构与安装包不匹配：就像给 64 位手机装了 32 位应用，包本身没问题，是放错了位置。少数情况是依赖（.NET 运行时）版本不对。先对架构，再谈其他。
实操：一步步搞定
第一步：确认架构与版本号
执行下面的命令，记下输出的架构和发行版信息：
uname -m cat /etc/os-release | head -n 3输出如x86_64就是 x64 包，aarch64选 ARM64 包。版本号用于选择与系统兼容的 PowerShell 版本。
第二步：用官方脚本一键安装
Linux / macOS：脚本会自动检测系统、架构并下载匹配的安装包（完整逻辑见 tools/install-powershell.sh）：
sudo bash -c "$(wget -qO- https://gitcode.com/GitHub_Trending/po/PowerShell/raw/master/tools/install-powershell.sh)"Windows：在 PowerShell 中执行：
Set-ExecutionPolicy Bypass -Scope Process -Force iex ((New-Object System.Net.WebClient).DownloadString('https://gitcode.com/GitHub_Trending/po/PowerShell/raw/master/tools/install-powershell.ps1'))第三步：验证安装结果
打开新终端执行：
pwsh -v能打印版本号（如PowerShell 7.x）即安装成功。想看完整信息，执行pwsh -c '$PSVersionTable'，输出效果如下：
第四步（可选）：从源码构建特定架构版本
当预编译包不支持你的平台时，可以 clone 仓库自己编译（流程见 docs/building/linux.md）：
Import-Module ./build.psm1 Start-PSBootstrap -Scenario Both Start-PSBuild -UseNuGetOrg构建完成后产物在./src/powershell-unix/bin/Debug/net11.0/linux-x64/publish/pwsh，直接运行即可。
避坑与进阶
- 现象：
command not found: pwsh。原因：装完没开新终端，PATH 没刷新。解法：重开终端，或export PATH=$PATH:/usr/local/bin - 现象：安装脚本中途报错退出。原因：无 sudo 权限或网络受限。解法：加
-skip-sudo-check前先确认sudo可用；受限网络可先下载包再手动安装 - 现象：能装但启动报 .NET 相关错误。原因：.NET 运行时版本与目标不匹配。解法：按 docs/building/linux.md 用
Start-PSBootstrap重新安装配套 SDK
想深入？看 docs/FAQ.md 里的构建与安装常见问题。
收尾
记住主线：先对架构，再用官方脚本，最后用pwsh -v验证，90% 的安装报错都会消失。
关键文件参考：
- tools/install-powershell.sh - Linux/macOS 一键安装脚本
- tools/install-powershell.ps1 - Windows 一键安装脚本
- docs/building/linux.md - 从源码构建 PowerShell 的完整指南
- global.json - 指定构建所需的 .NET SDK 版本
【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
