命令行与文本处理 / 系统课时
编写多行文本与格式化输出
编写多行文本与格式化输出
本课解决“如何稳定生成可读的配置、报告和命令文本”这一问题。你将组合 Here-String、-f 格式运算符与子表达式,在保留多行结构的同时控制字段宽度、数字补零和日期格式。
学习目标
- 区分可插值与原样输出的 Here-String
- 使用复合格式字符串控制对齐、数字和日期
- 生成并验证一段结构稳定的业务报告
使用 Here-String 保存多行结构
Here-String 适合保存配置片段、邮件正文、SQL 或命令模板。双引号形式以 @" 开始、以 "@ 结束,会展开变量和 $() 子表达式;单引号形式以 @' 开始、以 '@ 结束,内容按原样保留。
为兼容不同 PowerShell 版本,起始标记后立即换行,结束标记单独顶格放置。Here-String 通常包含结束标记前的换行;写入严格格式文件时,应确认末尾换行是否符合目标系统要求。
使用复合格式字符串控制字段
格式运算符 -f 的左侧是模板,右侧是按顺序传入的值。占位符从 {0} 开始,可写成 {索引,宽度:格式}:负宽度左对齐,正宽度右对齐,D3 可把整数补到三位,日期则可使用 yyyy-MM-dd HH:mm。
模板中的普通花括号必须写成 {{ 和 }}。数字与日期格式默认受当前区域设置影响;需要跨环境生成完全一致的金额或小数文本时,应显式选择区域设置,而不是依赖运行机器的默认值。
生成报告并验证
下面的脚本先格式化每条记录,再通过子表达式把多行结果嵌入 Here-String。示例中的时间为固定教学数据,实际业务时间可能不同。
$rows = @(
[pscustomobject]@{
Name = 'Order-A'
Count = 12
Time = [datetime]'2026-08-04T10:15:00'
}
[pscustomobject]@{
Name = 'Order-B'
Count = 7
Time = [datetime]'2026-08-04T10:20:00'
}
)
# 先把对象转换成宽度和格式稳定的文本行
$lines = foreach ($row in $rows) {
"{0,-8}|{1:D3}|{2:yyyy-MM-dd HH:mm}" -f `
$row.Name, $row.Count, $row.Time
}
$report = @"
Daily Report
Generated: 2026-08-04 10:30
Name |Cnt|Time
$($lines -join "`n")
"@
$report预期输出:
Daily Report
Generated: 2026-08-04 10:30
Name |Cnt|Time
Order-A |012|2026-08-04 10:15
Order-B |007|2026-08-04 10:20脚本中 $($lines -join "n")是子表达式:它先把数组连接成多行字符串,再插入模板。若直接写$lines`,PowerShell 会按默认数组字符串化规则展开,结果不一定符合目标版式。
关键边界与选择建议
生成固定模板但允许变量替换时,使用双引号 Here-String;保存正则、脚本片段或含大量 $ 的原始内容时,优先使用单引号 Here-String。仅格式化一行时直接使用 -f,不要为了多行外观引入不必要的模板层。
-f 只负责生成字符串,不会截断过长字段。若字段可能超过列宽,应先校验长度、截断或改用 CSV、JSON 等结构化格式,避免对齐后的文本被误当成可靠数据接口。