如何减少PowerShell模块Pester测试文件中的样板代码？

针对你当前测试文件中重复编写模块加载/卸载逻辑的问题，有几种实用方案可以减少冗余：

方案一：复用现有入口测试脚本（tests/pester.ps1） #

你的项目已经包含tests/pester.ps1，可以将模块加载/卸载的全局逻辑放在这里，替代每个测试文件的重复代码：

修改tests/pester.ps1内容：

$modName = 'the_module_name'
# 自动解析模块清单路径，避免硬编码相对路径
$modManifestPath = Join-Path -Path $PSScriptRoot -ChildPath "..\$modName\$modName.psd1" -Resolve

# 全局前置操作：所有测试执行前加载模块
BeforeAll {
    Import-Module $using:modManifestPath -Force
}

# 全局后置操作：所有测试完成后卸载模块
AfterAll {
    Remove-Module -Name $using:modName -ErrorAction SilentlyContinue
}

# 执行所有测试用例
Invoke-Pester -Path $PSScriptRoot -Output Detailed

之后，所有测试文件（如Get-MyThings.Tests.ps1）无需再编写BeforeAll/AfterAll的模块操作逻辑，直接编写测试用例即可。

方案二：创建共享初始化脚本 #

如果需要更灵活的测试初始化（比如不同测试组需要不同初始化逻辑），可以在tests目录下创建共享脚本：

1. 在tests目录新建Shared/ModuleSetup.ps1，内容如下：

$modName = 'the_module_name'
$modManifestPath = Join-Path -Path $PSScriptRoot -ChildPath "..\..\$modName\$modName.psd1" -Resolve
Import-Module $modManifestPath -Force

# 可选：在这里添加通用测试依赖，比如定义全局变量、模拟对象等

2. 在每个测试文件的BeforeAll中仅需引入该脚本：

BeforeAll {
    . "$PSScriptRoot\..\Shared\ModuleSetup.ps1"
}

AfterAll {
    Remove-Module -Name 'the_module_name' -ErrorAction SilentlyContinue
}

方案三：使用Pester配置文件 #

通过pester.config.json定义全局测试钩子，让所有测试文件自动应用模块加载逻辑：

在项目根目录或tests目录创建pester.config.json：

{
    "BeforeAll": [
        "$modName = 'the_module_name'; $modPath = Join-Path -Path $PSScriptRoot -ChildPath '../the_module_name/the_module_name.psd1' -Resolve; Import-Module $modPath -Force"
    ],
    "AfterAll": [
        "Remove-Module -Name $modName -ErrorAction SilentlyContinue"
    ]
}

执行测试时，Pester会自动读取该配置并应用全局钩子，测试文件无需重复编写初始化代码。

额外建议 #

• 避免硬编码模块名称和路径：使用Resolve-Path或Join-Path动态解析路径，减少因目录结构变更导致的维护问题。
• 检查PSModuleDevelopment模板配置：该模板可能内置了测试优化选项，可通过Get-PSMDTemplate查看模板参数，生成时直接指定共享测试初始化的配置。

内容的提问来源于stack exchange，提问作者Mark Mascolino