技能介绍

为什么 Windows PowerShell 容易踩坑

在 Windows 上写 PowerShell 时，很多错误来自语法细节而不是 cmdlet 本身：if 里把 -or / -and 直接写在 cmdlet 参数后面会触发「参数 'or'」；脚本里用 emoji 或特殊 Unicode 可能在控制台或旧编码下变成「意外的令牌」；对可能为 $null 的对象直接访问 .Count、.Length 会报找不到属性。路径拼接用字符串拼接、嵌套对象 ConvertTo-Json 不写 -Depth，也会在生产环境里悄悄丢数据。

技能覆盖的核心模式

本技能把 Windows PowerShell 模式 整理成可对照的检查清单：

逻辑运算：每个 cmdlet 调用在 -or / -and 两侧都要用括号，例如 if ((Test-Path "a") -or (Test-Path "b"))。
输出字符集：脚本内状态与提示只用 ASCII 标记（如 [OK]、[!]），避免 ✅、⚠️ 等符号。
空值：先判断 $array、$text 是否存在，再读 .Count 或 .Length。
路径：变量与相对路径用 Join-Path，字面 Windows 路径保持 C:\... 形式。
JSON：读写嵌套结构时固定 ConvertTo-Json -Depth 10（或按需加大），配合 Get-Content -Raw 与 UTF8 写出。
错误处理：开发可用 $ErrorActionPreference = 'Stop'；try/catch 里避免 return，清理放在 finally，返回值放在块外。

文末还对照常见错误信息与修复方式，便于和 CI/本地日志对号入座。

适用边界

内容针对 Windows PowerShell / Windows 环境 的惯用法与陷阱，不替代完整语言教程；跨平台 PowerShell 7+ 在路径与部分行为上与 Windows PowerShell 5.x 仍有差异，迁移时需单独验证。复杂字符串插值建议先赋给中间变量，技能只给出方向性模式而非覆盖所有表达式边界情况。