用途:为在 Windows PowerShell 中编写脚本提供关键模式与常见陷阱的参考,降低语法错误和运行时错误。
主要能力:
- 运算符语法:使用 -or、-and 等逻辑运算符时,每个 cmdlet 调用必须加括号,例如 if ((Test-Path "a") -or (Test-Path "b"))。
- Unicode/Emoji 限制:脚本内只用 ASCII 字符,成功用 [OK] [+],错误用 [!] [X],警告用 [*] [WARN],信息用 [i] [INFO],进度用 [...]。
- 空值检查:访问属性前先判断对象是否存在,例如 $array -and $array.Count -gt 0、if ($text) { $text.Length }。
- 字符串插值:复杂表达式先存入变量再输出,避免直接内嵌多级属性。
- 错误处理:ErrorActionPreference 可选 Stop(开发快速失败)、Continue(生产脚本)、SilentlyContinue(预期会出错时);try/catch 中不要在 try 内 return,finally 做清理,返回放在 try/catch 之后。
- 文件路径:使用 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。
- 常见错误对照:缺括号、Unicode 字符、空对象、类型不匹配等对应修复方式。
- 脚本模板:建议 Set-StrictMode -Version Latest,设置 $ScriptDir,用 try/catch 包裹主逻辑并以 exit 码结束。
适用场景:编写或审查 Windows PowerShell 脚本、排查语法与运行错误、统一脚本编码风格。
限制:仅在任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。