（1818期）PowerShell – PowerShell 避坑实战手册

PowerShell 避坑实战手册 PowerShell 7+ 避坑指南：输出行为、数组陷阱、比较运算符等常见错误详解，适合跨平台脚本开发者 使用说明 核心用法 本技能聚焦于 PowerShell 7+ (pwsh) 的核心陷阱与最佳实践，涵盖以下关键领域： 1. 输出行为控制 隐式输出：PowerShell 中任何未捕获的表达式都会输出，即使没有 return 语句。return 仅表示退出点，不会阻止之前的输出。 抑制输出：使用 $null = Function() 或 [void](Function()) 显式丢弃不需要的输出。 显示 vs 数据：Write-Host 直接写入控制台，绕过管道；数据传递应依赖隐式输出或 Write-Output。 2. 数组陷阱 标量 vs 数组：单元素结果自动降级为标量，使用 @(expression) 强制数组包装。 空结果处理：空查询返回 $null 而非空数组，需用 if ($result) 而非 if ($result.Count -eq 0) 判断。 性能优化：+= 在循环中创建新数组，大数据量时应换用 [System.Collections.ArrayList]。 3. 比较运算符 语法差异：使用 -eq、-ne、-gt、-lt，而非 C 风格的 ==、!=、>、<。 空值安全：始终将 $null 放在左侧（$null -eq $var），避免数组比较时的意外行为。 成员检测：-contains 用于数组成员检查，支持管道友好操作。 4. 跨平台兼容 版本识别：pwsh 指向 PowerShell 7+，powershell 为 Windows 旧版 5.1。 路径处理：优先使用 Join-Path，避免硬编码分隔符。 别名风险：ls、cat 等平台别名不可靠，脚本中应使用完整 Cmdlet 名称。 显著优点 实战导向：直击 PowerShell 最频繁的踩坑点，节省调试时间。 跨平台覆盖：明确区分 Windows PowerShell 与 PowerShell Core 差异。 性能意识：包含数组操作、管道流式处理等性能关键建议。 潜在缺点与局限性 版本限定：内容针对 PowerShell 7+，部分语法在 Windows PowerShell 5.1 中不完全适用。 深度有限：属于速查手册风格，复杂场景（如 DSC、JEA 等高级功能）未涉及。 Windows 偏向：虽然标注跨平台，但部分陷阱（如别名差异）仍以 Windows 用户视角为主。 适合人群 从 Bash/Python/C# 等语言迁移至 PowerShell 的开发者 需要编写可移植跨平台脚本的 DevOps/SRE 工程师 维护现有 PowerShell 代码库、希望减少技术债务的团队 常规风险 隐式输出泄漏敏感数据：未正确抑制输出的函数可能在管道中意外暴露信息。 数组/标量混淆导致逻辑错误：单元素自动降级可能破坏下游的类型敏感操作。 错误处理遗漏：非终止错误默认继续执行，try/catch 需配合 -ErrorAction Stop 才有效。 平台差异脚本失败：依赖 Windows 特有别名或路径格式的脚本在 Linux/macOS 上直接报错。 原始说明 Avoid common PowerShell mistakes — output behavior, array traps, and comparison operator gotchas.