企业官网建设流程全解析

PowerShell 7 装不上？3 步解决"命令找不到"与架构不匹配

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

终端里冒出pwsh: command not found或Exec format error，你不知道该怪包还是怪步骤。这篇文章解决 PowerShell 安装失败的问题，从下面的 30 秒自查开始，一般 5 分钟内就能确认并修好。

30 秒自查：先确认是不是真坏了

先排除两种"假故障"，它们占了安装问题的大头：

• 执行which pwsh（Linux/macOS）或Get-Command pwsh（Windows）。有路径返回，说明其实已经装好，只是没进 PATH——这是环境变量问题，不是安装失败。
• 执行uname -m看 CPU 架构：x86_64对应 x64 包，arm64对应 ARM64 包。多数Exec format error到这一步就有答案。
• 看下载包的文件名：里面的x64/arm64必须和上面架构一致；在 Linux 上下载 Windows 的.msi，到这一步结论就很清楚了。
• 你所在的终端是新开的吗？安装完成后 PATH 只在新会话里刷新，旧终端里pwsh找不到属于正常现象。

对照报错找原因：常见报错怎么办

• pwsh: command not found→ 二进制不在 PATH，或安装根本没完成 → 先查安装目录，再修 PATH 或软链接。
• Exec format error: bad magic→ 包架构与 CPU 不符（或下载损坏）→ 重下匹配架构的包，不确定就核对官方校验值。
• bash: permission denied→ 文件缺执行权限，或从 Windows 拷贝带来 CRLF 换行 → 用chmod +x补权限，或重新下载一份干净的。
• running scripts is disabled（Windows）→ 执行策略拦截了脚本 → 不用放宽系统策略，单次用-ExecutionPolicy Bypass绕过即可。

🧰 主路径修复：官方安装脚本怎么用

第一步：拿到官方安装脚本。脚本在仓库tools/目录里，能自动识别架构并装匹配包，这是避免装错架构的关键。

git clone https://gitcode.com/GitHub_Trending/po/PowerShell

克隆完成后，tools/下有两个脚本：tools/install-powershell.sh（Linux/macOS 用）和 tools/install-powershell.ps1（Windows 用）。

第二步：Linux/macOS 运行安装。脚本内部自己做架构检测与选包，不需要手动挑版本。

cd PowerShell && bash tools/install-powershell.sh

看到日志走到安装完成、并创建了pwsh软链接（Linux 在/usr/bin/pwsh，macOS 在/usr/local/bin/pwsh）就算正常。想装预览版时加-Preview，与正式版并行安装、互不覆盖。

第三步：Windows 改用 PowerShell 版脚本。-AddToPath会把安装目录写入用户 PATH，省去手动配置环境变量。

powershell -ExecutionPolicy Bypass -File tools\install-powershell.ps1 -AddToPath

看到无报错并打印出安装路径即为正常；弹出安全确认窗口时允许继续。

主路径走不通？

• 用 Docker 跑官方镜像：docker run -it mcr.microsoft.com/powershell pwsh，适合依赖过旧或不在支持列表的系统，容器里直接开跑。
• 源码编译：官方不覆盖的架构，按 docs/building/linux.md 用Start-PSBuild编译匹配版本。

✅ 验收：一条命令确认装好

新开终端，执行：

pwsh --version

输出PowerShell 7.x.x即修复完成。最容易被误判的一点：必须在新开的终端里验证，旧会话 PATH 没刷新，装好了也会提示找不到命令，别把它当成又失败了。

FAQ

1. 安装完成却还提示"command not found"，怎么办？先确认软链接存在：Linux 看ls -l /usr/bin/pwsh，Windows 看Get-Command pwsh。链接在但指向为空，说明包架构不匹配，删掉重装正确架构即可。

2. Windows 提示"运行脚本已被禁用"，怎么办？在命令行加-ExecutionPolicy Bypass，只对当次执行生效，不改动系统策略；不建议把策略长期改成 Unrestricted。

3. 开发 Cmdlet 时 NuGet 找不到包，算安装失败吗？不一定，通常是网络或包源配置问题。在 NuGet 包管理器里选择包源并安装所需包即可：

按官方示例 docs/cmdlet-example/ 配置包源与引用，问题就能解决。

再遇到类似问题时，把报错原文抄回"对照报错找原因"一栏查一下，报错通常已经写明了要修哪一步。

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