Pester 5 里为什么不能在 Describe 外写 $fixture = Get-Content ... 然后直接在 It 里用？

Pester 5 先执行发现阶段再运行测试，容器外的赋值时机和运行阶段不共享，变量可能为空；准备逻辑应放进 BeforeAll。

怎样验证函数确实调用了一次外部 API，而不是真的发请求？

用 Mock Invoke-RestMethod 替换实现，再用 Should -Invoke Invoke-RestMethod -Times 1 -Exactly 断言调用次数和参数。

流水线里 Pester 失败但任务仍显示成功，最可能缺了什么？

缺少 -CI 或没有检查 Pester 结果对象；默认失败不保证进程返回非零退出码，要在入口显式设置。

系统学习 学习路径总入口：先选领域，再建立模型，最后用故障演练验证

版本信息最后核对：2026-10-25

用 Pester 给脚本和模块写可重复的测试，覆盖成功、失败和边界路径

适用场景

脚本开始被多人使用、要接入 CI、或修改后需要确认没有回归时，就应该写测试。适合验证函数返回值、抛错条件、管道输入、模块导出边界，以及对外部命令的调用次数。

一次性排障脚本不需要完整测试；但任何会被计划任务、发布流水线或其他人复用的逻辑，都值得至少覆盖主路径和一个失败路径。

核心概念

测试结构：Describe 描述一个被测对象，Context 划分场景，It 是最小断言。文件名通常以 .Tests.ps1 结尾，便于 Pester 发现。
断言与生命周期：Pester 5 用 Should -Be、-Throw、-Match、-HaveCount 等操作符；BeforeAll 在每个容器前执行一次，BeforeEach 在每个 It 前执行，AfterAll 负责清理。
Mock：Mock 替换命令实现，验证代码是否按预期调用外部依赖；Should -Invoke 断言调用次数和参数。模块内部函数要用 InModuleScope 或 -ModuleName 才能 Mock。
执行与覆盖率：Invoke-Pester -Output Detailed 输出每个用例；-CI 让失败时返回非零退出码；-CodeCoverage 生成脚本覆盖率，但不等于逻辑覆盖。

5.1 与 7.x 差异

Windows 环境常见的自带版本是 Pester 3.4，语法和 Pester 5 差异很大；先 Get-Module -ListAvailable Pester 确认版本，再安装 5.x。
Pester 5 可运行在 5.1 和 7.x 上，但较新的 Pester 版本可能提高最低 PowerShell 要求；5.1 上固定一个仍支持 5.1 的 5.x 版本，升级前看模块清单。
5.1 默认按 ANSI 读取无 BOM 的 UTF-8 脚本，测试文件含中文时容易乱码或断言失败；用 UTF-8 BOM 保存，或在 7.x 中运行。

常用操作

# 1. 确认 Pester 版本；旧版 3.4 的断言语法不能直接套用
PS C:\> Get-Module -ListAvailable Pester | Select-Object Name, Version, Path
PS C:\> Install-Module Pester -Scope CurrentUser -MinimumVersion 5.0 -Force

# 2. 被测函数，保存为 Get-Widget.ps1
function Get-Widget {
    param([string] $Name)
    if (-not $Name) { throw 'Name required' }
    [pscustomobject]@{ Name = $Name; Id = 42 }
}

# 3. 测试文件 Get-Widget.Tests.ps1
BeforeAll { . $PSScriptRoot/Get-Widget.ps1 }
Describe 'Get-Widget' {
    It 'returns the requested name' { (Get-Widget -Name 'api').Name | Should -Be 'api' }
    It 'throws for an empty name' { { Get-Widget -Name '' } | Should -Throw }
}

# 4. 运行单文件并输出详细结果；CI 中让失败返回非零并收集覆盖率
PS C:\> Invoke-Pester -Path .\Get-Widget.Tests.ps1 -Output Detailed
PS C:\> Invoke-Pester -Path .\tests -CI -CodeCoverage .\Get-Widget.ps1

# 5. Mock 外部依赖，验证调用次数而不是真的发请求
Describe 'Remove-Widget' {
    BeforeAll { function Remove-Widget { param($Name) Invoke-RestMethod -Uri "https://api.example.test/widgets/$Name" -Method Delete } }
    It 'calls the API once' {
        Mock Invoke-RestMethod { @{ ok = $true } }
        Remove-Widget -Name 'api'
        Should -Invoke Invoke-RestMethod -Times 1 -Exactly
    }
}

易错点

把 Pester 3/4 的 Should Be、Assert-MockCalled 直接用在 Pester 5 上会报参数错误。先看版本，再统一用 Should -Be 和 Should -Invoke。
Pester 5 先发现再运行：写在 Describe/It 外、BeforeAll 外的变量赋值在运行阶段可能为 $null。准备逻辑放进 BeforeAll。
测试依赖真实网络、真实注册表或上一轮留下的文件，结果会时好时坏。用 Mock 隔离外部调用，用 TestDrive: 放临时文件。
没有 -CI 时，测试失败只打印结果，进程退出码可能仍是 0；流水线会误判成功，入口命令要显式加 -CI 或检查结果对象。

参考链接

读完自测

合上页面，先回答，再展开对照。

Pester 5 里为什么不能在 Describe 外写 $fixture = Get-Content ... 然后直接在 It 里用？
怎样验证函数确实调用了一次外部 API，而不是真的发请求？
流水线里 Pester 失败但任务仍显示成功，最可能缺了什么？

答案

Pester 5 先执行发现阶段再运行测试，容器外的赋值时机和运行阶段不共享，变量可能为空；准备逻辑应放进 BeforeAll。
用 Mock Invoke-RestMethod 替换实现，再用 Should -Invoke Invoke-RestMethod -Times 1 -Exactly 断言调用次数和参数。
缺少 -CI 或没有检查 Pester 结果对象；默认失败不保证进程返回非零退出码，要在入口显式设置。