PowerShell 7 跨平台自动化快速上手指南：从源码构建到运行第一条命令
【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell
PowerShell 7 是一款免费的跨平台自动化工具，运行在 Windows、Linux 和 macOS 上，内置命令行外壳与脚本语言，擅长处理 JSON、CSV 等结构化数据。面向新手和运维、开发同学，本文带你完成源码构建，亲手跑通第一条 pwsh 命令。
场景速览：一条脚本打通三端运维任务
先看它对你日常工作的价值，再动手构建。假设你经常在三台不同系统的机器上处理同类任务：合并服务器日志、按条件筛选 CSV、批量重命名文件。用 PowerShell 7，同一份脚本可以在 Windows 开发机、Linux 生产机和 Mac 本地直接复用：
# 导入当前目录全部 CSV，筛选含 Error 的行并统计 Get-ChildItem *.csv | Import-Csv | Where-Object { $_.Level -eq 'Error' } | Group-Object Source | Format-Table -AutoSize相比 bash 的文本管道，PowerShell 传递的是对象，省掉大量字符串切分。想进一步自定义命令时，仓库自带完整示例：cmdlet 开发示例文档。
动手前检查：环境、依赖与权限清单
构建前花两分钟把这几项过一遍，可以避开九成常见的报错。
- 架构确认：Linux 执行
uname -m，结果为 x86_64 或 aarch64 均可；Windows 用systeminfo查看系统类型 - 网络可用：构建过程会下载 .NET SDK 与 NuGet 包，需能正常访问外网
- 权限确认：Linux/macOS 安装 pwsh 需要 sudo；源码构建本身用普通用户即可
- 磁盘空间：预留数 GB 空闲；.NET SDK 的固定版本见 global.json
上手操作：四步完成 PowerShell 7 源码构建
以上检查都通过后，就可以开始构建了，全程约十分钟。
1. 拉取 PowerShell 7 源码仓库
目标：把完整源码拿到本地目录。执行下面的命令（适用所有系统）：
# 拉取完整源码并进入仓库根目录 git clone https://gitcode.com/GitHub_Trending/po/PowerShell cd PowerShell预期结果：本地出现 PowerShell 目录，内含src、docs、tools子目录和 build.psm1 构建模块。
2. 安装 pwsh 并引导编译依赖
目标：构建脚本本身用 PowerShell 编写，先装好 pwsh 本体，再让它自动装齐 .NET SDK 等依赖。先执行安装脚本（适用 Linux/macOS）：
# 仓库自带脚本，自动下载并安装 pwsh ./tools/install-powershell.sh pwsh预期结果：进入 PowerShell 控制台。接着运行引导命令：
# 导入构建模块，自动安装 .NET SDK 与打包工具 Import-Module ./build.psm1 Start-PSBootstrap -Scenario Both预期结果：.NET SDK 安装到~/.dotnet，无需手动下载任何组件。
3. 执行源码构建
目标：编译全部源码并产出 pwsh 可执行文件。运行构建命令（适用所有系统）：
# 使用公开 NuGet 源构建，避免私有源鉴权问题 Start-PSBuild -UseNuGetOrg预期结果：构建成功，终端打印可执行文件路径，Linux 上形如./src/powershell-unix/bin/Debug/net11.0/linux-x64/publish/pwsh。
4. 验证版本并运行第一条命令
目标：确认你构建的 pwsh 版本正确可用。执行下面的命令（Linux 路径，Windows 请换用pwsh.exe）：
# 运行刚构建的 pwsh 并打印版本号 ./src/powershell-unix/bin/Debug/net11.0/linux-x64/publish/pwsh -c '$PSVersionTable.PSVersion'预期结果：输出 7.x 的版本号。之后可以执行Get-Command查看内置命令列表，正式上手。
进阶玩法与常见问题答疑
构建和运行都通了，还有两个值得尝试的扩展方向。
可选方案一：用 C# 写自己的 Cmdlet。参照 cmdlet 示例文档，在 Visual Studio 里新建一个 .NET Core 类库项目：
核心代码只有几行，编译后的程序集可直接Import-Module加载：
可选方案二：跑一遍测试套件，验证构建质量：
# 运行跨平台 Pester 测试（同样使用公开 NuGet 源） Start-PSPester -UseNuGetOrg以下是三个高频问题：
Q：构建时提示 NuGet 源无法访问或需要鉴权？A：给Start-PSBuild和Start-PSPester都加上-UseNuGetOrg，切换到公开 NuGet.org 即可。
Q：PowerShell 7 和 Windows 自带的 5.1 会冲突吗？A：可以共存。5.1 的可执行文件是 powershell.exe，7 是 pwsh.exe，互不影响。本仓库只跟踪 7.x 的问题。
Q：.NET SDK 版本不匹配导致构建失败怎么办？A：重新运行Start-PSBootstrap，它会按 global.json 固定版本自动安装匹配的 SDK。
到这里，你已经完成了从源码构建到验证 pwsh 的完整流程，升级版本或开发自定义 Cmdlet 都可以沿用这套方法。
关键文件参考
- build.psm1：构建模块，提供 Start-PSBootstrap / Start-PSBuild
- docs/building/linux.md：Linux 构建指南
- docs/building/windows-core.md：Windows 构建指南
- docs/FAQ.md：开发者常见问题
- CHANGELOG/7.6.md：最新版本更新日志
- src/powershell/：主机程序源码
【免费下载链接】PowerShellPowerShell for every system!项目地址: https://gitcode.com/GitHub_Trending/po/PowerShell
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
