命令行与文本处理 / 系统课时
编写 Pester 测试
编写 Pester 测试
本课通过一个订单金额函数,完整演示如何用 Pester 组织测试层级、编写断言,并分别验证正常结果与参数异常。完成后,你将得到一组可重复执行、失败原因清晰的单元测试。
学习目标
- 使用
Describe、Context和It组织测试用例 - 使用
Should断言验证返回值与异常 - 运行测试并根据结果定位失败用例
认识测试层级
Describe 对应一个被测单元,Context 按输入条件或业务场景分组,It 描述一个可验证行为;断言通常写在 It 内。这样的层级能让测试报告直接呈现“哪个场景下的哪个行为失败”。:contentReference[oaicite:0]{index=0}

编写被测函数
将下面内容保存为 Order.ps1。函数负责计算订单金额:标准会员按原价结算,金牌会员享受九折,同时通过参数验证拒绝无效数量和单价。
function Get-OrderTotal {
[CmdletBinding()]
param(
[Parameter(Mandatory)]
[ValidateRange(1, 100)]
[int]$Quantity,
[Parameter(Mandatory)]
[ValidateScript({ $_ -gt 0 })]
[decimal]$UnitPrice,
[ValidateSet('Standard', 'Gold')]
[string]$MemberLevel = 'Standard'
)
$total = $Quantity * $UnitPrice
# 折扣规则集中在函数内部,测试只验证对外行为
if ($MemberLevel -eq 'Gold') {
return [math]::Round($total * 0.9, 2)
}
return [math]::Round($total, 2)
}该脚本只定义函数,不主动产生控制台输出。验证方法是在同一目录创建测试文件并通过 Invoke-Pester 调用。
组织正常与异常路径
将下面内容保存为 Order.Tests.ps1。BeforeAll 只加载一次被测脚本;两个 Context 分别覆盖有效参数和无效参数,避免把不同失败原因混在同一组用例中。
BeforeAll {
. "$PSScriptRoot/Order.ps1"
}
Describe 'Get-OrderTotal' {
Context '参数有效' {
It '标准会员返回原价' {
$result = Get-OrderTotal -Quantity 2 -UnitPrice 100
$result | Should -Be 200
}
It '金牌会员应用九折' {
$result = Get-OrderTotal -Quantity 2 -UnitPrice 100 -MemberLevel Gold
$result | Should -Be 180
}
}
Context '参数无效' {
It '数量为零时抛出验证异常' {
{ Get-OrderTotal -Quantity 0 -UnitPrice 100 } |
Should -Throw '*Quantity*'
}
It '单价非正数时抛出验证异常' {
{ Get-OrderTotal -Quantity 1 -UnitPrice 0 } |
Should -Throw '*UnitPrice*'
}
}
}Should -Be 比较实际值与期望值,Should -Throw 则要求脚本块必须抛出异常。把异常调用包在 {} 中十分关键,否则异常会在断言接管前直接中断测试。
执行并判断结果
在两个文件所在目录运行测试。示例使用 Pester 的详细输出模式,便于查看每个 Context 和 It 的执行结果。
Invoke-Pester -Path ./Order.Tests.ps1 -Output Detailed预期输出
Describing Get-OrderTotal
Context 参数有效
[+] 标准会员返回原价
[+] 金牌会员应用九折
Context 参数无效
[+] 数量为零时抛出验证异常
[+] 单价非正数时抛出验证异常
Tests completed in <TIME>
Tests Passed: 4, Failed: 0, Skipped: 0<TIME> 会随机器性能和 Pester 版本变化。只要四个用例全部通过且失败数为零,就说明正常路径与异常路径均符合当前规则。
关键边界
每个 It 应只验证一个明确行为,名称要能表达输入条件和预期结果。测试数据应固定且可读,避免使用当前时间、随机数或真实网络响应,否则同一测试可能在不同运行中得到不同结论。
当生产规则发生变化时,应先修改或新增对应测试,再调整实现。不要为了让测试“变绿”而删除异常路径,因为参数验证往往正是脚本进入生产环境后的安全边界。