命令行与文本处理 / 系统课时
使用 ForEach-Object 转换
使用 ForEach-Object 转换
ForEach-Object 用来逐个处理管道中的对象。学完本课,你将能使用 $_ 读取当前对象,生成新的对象或计算字段,并分清“转换数据”和“产生副作用”两类用法。
学习目标
- 使用
ForEach-Object对每个管道对象执行脚本块 - 理解
$_、$PSItem与外部变量的作用 - 在转换、计算和副作用之间做出合适选择
基本工作方式
ForEach-Object 接收上游对象,并为每个对象执行一次 -Process 脚本块。脚本块最后写入成功输出流的内容,会继续进入下游管道;没有输出的语句只完成内部操作。
当前对象可通过 $_ 访问,$PSItem 是它的完整别名。二者含义相同,常用写法是 $_.PropertyName。% 虽然是命令别名,但教学脚本和生产脚本更适合写完整名称,以便阅读和搜索。
转换对象并计算字段
下面把订单金额转换为带序号、税额和含税总额的新对象。$sequence++ 修改了脚本块外部变量,属于副作用;创建 [pscustomobject] 则是管道转换的主要结果。
$orders = @(
[pscustomobject]@{ OrderNo = 'A1001'; Amount = 120 }
[pscustomobject]@{ OrderNo = 'A1002'; Amount = 75 }
[pscustomobject]@{ OrderNo = 'A1003'; Amount = 200 }
)
$sequence = 0
$result = $orders | ForEach-Object {
$sequence++
$tax = [math]::Round($_.Amount * 0.06, 2)
[pscustomobject]@{
Sequence = $sequence
OrderNo = $_.OrderNo
Amount = $_.Amount
Tax = $tax
Total = [math]::Round($_.Amount + $tax, 2)
}
}
$result | ForEach-Object {
'{0}|{1}|{2:F2}|{3:F2}|{4:F2}' -f $_.Sequence, $_.OrderNo, $_.Amount, $_.Tax, $_.Total
}预期输出
1|A1001|120.00|7.20|127.20
2|A1002|75.00|4.50|79.50
3|A1003|200.00|12.00|212.00实际输出中的小数点符号可能受系统区域设置影响。示例通过格式字符串固定两位小数,但部分区域可能显示逗号作为小数分隔符。
自动变量与脚本块阶段
最常用形式只有一个脚本块,它等价于 -Process。需要初始化资源或最后汇总时,可以显式使用 -Begin、-Process 和 -End:Begin 执行一次,Process 对每个输入执行一次,End 在输入结束后执行一次。
$_ 只在处理当前管道对象的上下文中有意义。若在脚本块外读取它,通常得不到期望值。外部变量可以在脚本块内读取和修改,但并行处理或远程执行时需要重新考虑变量作用域与线程安全。
转换与副作用的边界
生成新对象、修改字段或格式化值属于转换,适合继续传给 Where-Object、Sort-Object 或导出命令。写日志、更新文件、调用外部接口和修改计数器属于副作用,应保证失败可发现、重复执行可接受。
不要在同一个复杂脚本块中同时完成大量转换和外部写入。更稳妥的做法是先构造结果对象并验证,再单独执行保存或调用操作,这样更容易重试和测试。
常见错误
把 ForEach-Object 与语言关键字 foreach 混为一谈是最常见的问题。前者按管道逐个处理,适合流式组合;后者遍历已存在的集合,语法更直接,通常也更容易调试。
另一个错误是在脚本块中使用 return 期待终止整个脚本。这里的 return 只结束当前脚本块调用;若要过滤对象,应明确使用 Where-Object,若要终止脚本,应根据场景使用 throw、break 或外层控制逻辑。