该资料整理了 Windows PowerShell 的关键编码模式与易错点，用于编写更稳健的脚本。
用途：帮助开发者规避 PowerShell 特有的语法陷阱，统一脚本写法。
主要能力与要点：
- 运算符语法：使用逻辑运算符时，每个 cmdlet 调用必须加括号，例如 if ((Test-Path "a") -or (Test-Path "b"))。
- Unicode/Emoji 限制：脚本中只用 ASCII 字符，用 [OK]、[!]、[*]、[i]、[...] 等替代符号。
- 空值检查：访问属性前先判空，如 $array -and $array.Count -gt 0、if ($text) { $text.Length }。
- 字符串插值：复杂表达式先存入变量再输出，避免直接内嵌。
- 错误处理：ErrorActionPreference 可选 Stop（开发快速失败）、Continue（生产）、SilentlyContinue（预期错误）；try/catch 中不要在 try 内 return，用 finally 清理，在 try/catch 之后返回。
- 文件路径：用 Join-Path 拼接，如 Join-Path $env:USERPROFILE "file.txt"、Join-Path $ScriptDir "data"。
- 数组操作：空数组 $array = @()，添加项 $array += $item，ArrayList 用 $list.Add($item)。
- JSON：ConvertTo-Json 始终指定 -Depth，如 -Depth 10；读取用 Get-Content "file.json" -Raw。
- 常见错误对照：缺括号报 parameter 'or'，Unicode 报 Unexpected token，空对象报 Cannot find property，类型不匹配报 Cannot convert（用 .ToString()）。
- 脚本模板：Set-StrictMode -Version Latest、设置 $ErrorActionPreference、用 Split-Path 获取脚本目录，try 中输出 [OK] 并 exit 0，catch 中 Write-Warning 并 exit 1。
适用场景：Windows 平台自动化脚本、CI 任务、系统管理脚本编写。
限制：资料未提供具体版本兼容范围、性能数据或完整示例代码，部分内容以要点形式呈现。