用途:为在 Windows 上编写 PowerShell 脚本提供关键模式与易错点参考,减少语法与运行时错误。
主要能力:
- 运算符语法:使用逻辑运算符时,每个 cmdlet 调用必须加括号,例如 if ((Test-Path "a") -or (Test-Path "b"))。
- 字符限制:脚本中只用 ASCII,避免 Unicode 与 emoji,用 [OK]、[!]、[*]、[i]、[...] 等替代符号。
- 空值检查:访问属性前先判断对象是否存在,如 $array -and $array.Count -gt 0。
- 字符串插值:复杂表达式先存入变量再输出,避免 $($obj.prop.sub) 这类写法。
- 错误处理:按场景设置 $ErrorActionPreference(Stop/Continue/SilentlyContinue),使用 try/catch,不在 try 内 return,用 finally 清理。
- 路径:用 Join-Path 拼接,如 Join-Path $env:USERPROFILE "file.txt"。
- 数组:空数组用 @(),添加用 += 或 ArrayList.Add。
- JSON:ConvertTo-Json 始终指定 -Depth,读取用 Get-Content -Raw。
- 常见错误对照:缺括号、Unicode 字符、空对象、类型不匹配等。
- 脚本模板:Set-StrictMode -Version Latest,配合 try/catch 与退出码。
使用方式:作为编写或审查 PowerShell 脚本时的检查清单,按上述规则逐项核对。
适用场景:Windows 自动化脚本、运维任务、批处理与配置管理脚本开发。
限制:资料未提供具体版本兼容范围、依赖模块或完整示例代码,实际使用需结合环境验证。