
PowerShell 裝不上按這份排查清單逐步走10 分鐘跑通【免費下載鏈接】PowerShellPowerShell for every system!項目地址: https://gitcode.com/GitHub_Trending/po/PowerShellPowerShell 是微軟的跨平臺命令行自動化工具Windows、Linux、macOS 上都能裝用來跑腳本和管理系統。本文覆蓋用官方安裝腳本裝 PowerShell 時最常見的 4 類失敗場景幫你定位報錯出在架構、發行版還是 PATH裝完后還能順手驗證一遍。30 秒自檢用兩條命令定位安裝失敗點先跑這兩條自查命令再按報錯跳轉查處理器架構Linux/macOS 執行uname -mWindows 執行systeminfo | findstr OS Architecture——確認芯片是 x64 還是 ARM這是后面選包的全部依據查發行版是否被識別看安裝腳本輸出里的DistroBasedOn:一行——它決定了官方腳本愿不愿意繼續裝然后對號入座報錯Sorry, your operating system is based on xxx and is not supported→ 跳到 發行版不受支持報錯cannot execute binary file或Exec format error→ 看 架構不匹配裝完了但pwsh: command not found→ 看 找不到命令你的設備壓根沒有對應預編譯包如 32 位 ARM 的樹莓派→ 看 源碼編譯對癥修復按具體報錯修報錯Sorry, your operating system is based on xxx and is not supported一句話原因tools/install-powershell.sh 只認識 redhat、debian、osx、suse、amazonlinux、gentoo、mariner 這幾個發行版家族別的直接拒絕。最省事的繞法是容器里跑裝系統包則改用你發行版自己的包管理器docker pull mcr.microsoft.com/powershell docker run -it --rm mcr.microsoft.com/powershell pwshdocker run能進入PS /提示符就說明這條路通了。報錯cannot execute binary fileExec format error一句話原因拿的包和芯片架構對不上比如 ARM 機器上解壓了 x64 的 tarball。用uname -m的輸出重新對號x86_64→ x64aarch64/arm64→ arm64然后下對應包重裝。pwsh --version能正常返回版本號而不是報 format error就說明架構對了。報錯pwsh: command not found一句話原因tarball 解壓到/usr/local/microsoft/powershell/7/后/usr/local/bin下沒建軟鏈shell 找不到命令。補一條軟鏈即可sudo ln -s /usr/local/microsoft/powershell/7/pwsh /usr/local/bin/pwsh新終端里pwsh -v返回 7.x.x就算修好了。你的架構沒有預編譯包從源碼編譯一句話原因32 位 ARM 等小眾架構沒有現成包只能自己編構建過程會從 NuGet 拉依賴包。clone 倉庫后按 docs/building/linux.md 的思路走git clone https://gitcode.com/GitHub_Trending/po/PowerShell cd PowerShell Import-Module ./build.psm1 Start-PSBootstrap -Scenario Both Start-PSBuild -UseNuGetOrg成功后運行./src/powershell-unix/bin/Debug/net11.0/linux-x64/publish/pwsh就能進入剛編出來的 PowerShellARM32 設備編譯時加-Runtime linux-arm。裝后驗證確認裝好的 pwsh 真的能跑三條命令各跟一句預期全部對上才算裝好pwsh -c $PSVersionTable.PSVersion→ 應返回 7.x.xpwsh -c $PSVersionTable.OS→ 應返回你當前的系統名Linux / Darwin / Windowsuname -m→ 輸出應與當初選的包架構一致x64 包對應 x86_64防坑備忘下次記住這 5 件事 選包前先記下uname -m的輸出x86_64 就是 x64、aarch64/arm64 就是 arm64別拿別的機器的 tarball 直接復用裝完提示pwsh: command not found先查/usr/local/bin軟鏈在不在別一上來就重跑安裝腳本編譯時 .NET SDK 版本由 global.json 固定先跑Start-PSBootstrap裝匹配的 SDK別指望本機已有的 dotnet 能直接編macOS 的 Apple Silicon 要裝 arm64 包不要用 x64 包走 Rosetta 將就 Windows 上腳本被執行策略攔住時先Set-ExecutionPolicy Bypass -Scope Process再跑或者直接裝 MSI三條驗證命令都通過、架構對得上這次安裝就算徹底落地了。關鍵文件參考tools/install-powershell.sh — Linux/macOS 一行安裝腳本自動識別發行版和架構tools/install-powershell.ps1 — Windows 一行安裝腳本global.json — 固定編譯所需的 .NET SDK 版本【免費下載鏈接】PowerShellPowerShell for every system!項目地址: https://gitcode.com/GitHub_Trending/po/PowerShell創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考