Pester单元测试：点源脚本Mock失效与InModuleScope使用疑问

问题背景 #

使用Pester对PowerShell脚本做单元测试时，通过点源加载函数（. "$PSScriptRoot\tz-docker.functions.ps1"）后，Mock（如Mock Get-Service）不生效，实际调用的是真实命令。原因是点源函数在Mock运行前就加载到全局作用域，Pester无法拦截内部的Get-Command或Get-Service调用。

已知两种常规解决方法：

• 将逻辑打包为PowerShell模块并使用InModuleScope
• 在测试文件中内联定义函数（不适用于大型项目）

需要解决两个核心问题：

1. 是否有可靠方法让Mock在点源脚本环境下生效？
2. 若采用模块方案，有没有更简洁的方式全局应用InModuleScope，而非逐个包裹It块？

解决方案 #

1. 点源脚本环境下让Mock生效的可靠方法 #

Pester的Mock默认仅对当前作用域及子作用域有效，点源加载的函数在全局作用域运行，直接Mock全局命令会影响整个会话，需谨慎使用。以下两种方法可实现有效Mock：

方法一：指定全局作用域Mock命令

在Mock时添加-Scope Global参数，强制覆盖全局作用域的命令。测试结束后需手动清理Mock，避免影响后续操作：

Describe "Test-TzDockerInstalled" {
    Context "When Docker is NOT installed" {
        It "Returns `$false if Docker command is not found" {
            # 全局Mock Get-Command
            Mock Get-Command { return $null } -Scope Global
            
            # 执行测试
            Test-TzDockerInstalled | Should -Be $false
            
            # 清理全局Mock
            Remove-Mock Get-Command -Scope Global
        }
    }
}

方法二：在测试作用域内点源加载脚本

不要在脚本最外层点源加载函数，而是将点源操作放在Describe或Context块内，让函数和Mock处于同一子作用域中，Pester即可正常拦截内部命令调用：

Describe "Test-TzDockerInstalled" {
    # 在Describe作用域内加载脚本，而非全局
    . "$PSScriptRoot\tz-posh.globals.ps1" -Force
    . "$PSScriptRoot\tz-docker.functions.ps1" -Force

    Context "When Docker is installed" {
        It "Returns `$true if Docker command is found" {
            Mock Get-Command { return @{ Name = "docker" } }
            Test-TzDockerInstalled | Should -Be $true
        }
    }
}

2. 模块方案中全局应用InModuleScope的简洁方式 #

将脚本转为模块后，无需逐个It块包裹InModuleScope，可直接在Describe或Context块中使用该命令，作用于整个块内的所有测试：

步骤1：创建PowerShell模块

1. 新建tzdocker文件夹
2. 新建tzdocker.psm1文件，内容如下：

# 导入全局变量
. "$PSScriptRoot\tz-posh.globals.ps1"
# 导入函数
. "$PSScriptRoot\tz-docker.functions.ps1"

# 导出需要测试的函数
Export-ModuleMember -Function Test-TzDockerInstalled, Get-TzDockerService

3. 生成模块清单文件tzdocker.psd1，可通过New-ModuleManifest命令自动生成。

步骤2：在测试中全局应用InModuleScope

在Describe块中直接使用InModuleScope包裹所有测试逻辑，整个块内的测试都会在模块作用域中运行：

# 强制导入模块
Import-Module "$PSScriptRoot\tzdocker" -Force

Describe "Docker Functions Tests" {
    # 全局应用模块作用域
    InModuleScope "tzdocker" {
        Context "Test-TzDockerInstalled" {
            It "Returns `$true when Docker command exists" {
                Mock Get-Command { return @{ Name = "docker" } }
                Test-TzDockerInstalled | Should -Be $true
            }

            It "Returns `$false when Docker command does not exist" {
                Mock Get-Command { return $null }
                Test-TzDockerInstalled | Should -Be $false
            }
        }

        Context "Get-TzDockerService" {
            It "Returns service object when service exists" {
                Mock Get-Service {
                    return [PSCustomObject]@{
                        Name = 'com.docker.service'
                        Status = 'Running'
                    }
                }
                $result = Get-TzDockerService
                $result.Name | Should -Be 'com.docker.service'
                $result.Status | Should -Be 'Running'
            }

            It "Returns `$null when service does not exist" {
                Mock Get-Service { return $null }
                $result = Get-TzDockerService
                $result | Should -Be $null
            }
        }
    }
}

验证结果 #

修改后执行Invoke-Pester -Path .\tz-docker.functions.tests.ps1，所有测试应正常通过，不再调用真实的系统命令。

内容的提问来源于stack exchange，提问作者Tech with Thiru