如何避免Pester中Mock的Read-Host在代码覆盖率检测时弹出输入提示

这个坑我之前踩过——当启用-CodeCoverage参数时，Pester会对被测文件做代码插桩（instrumentation）来追踪覆盖情况，这时候普通的Mock Read-Host会失效，因为插桩后的函数会绕过测试作用域的Mock，直接调用原生的Read-Host。

下面给你两个最有效的解决方案：

方案1：针对模块函数使用InModuleScope #

如果你的Test-Foo是在PowerShell模块里，直接用InModuleScope块把Mock包裹起来，确保Mock作用于模块内部的作用域，这样插桩后的函数也会被Mock拦截：

Describe "Test-Foo" {
    Context "When something" {
        # 替换成你的模块名称
        InModuleScope MyTargetModule {
            Mock Read-Host { return "c:\example" }
        }
        
        $result = Test-Foo
        
        It "Returns correct result" {
            $result | Should -Be "c:\example"
        }
    }
}

方案2：封装Read-Host为自定义函数（通用方案） #

如果你的函数在脚本里，或者不想依赖模块作用域，最稳妥的方式是把Read-Host封装成一个自定义的内部函数，然后Mock这个自定义函数——因为Pester对自定义函数的Mock在代码覆盖率模式下不会失效：

修改被测函数： #

function Test-Foo {
    # 调用自定义的输入函数
    return (Get-UserInput "Enter value->")
}

# 封装Read-Host的内部函数
function Get-UserInput {
    param([string]$Prompt)
    Read-Host $Prompt
}

对应的测试代码： #

Describe "Test-Foo" {
    Context "When something" {
        # Mock自定义的Get-UserInput，而不是原生Read-Host
        Mock Get-UserInput { return "c:\example" }
        
        $result = Test-Foo
        
        It "Returns correct result" {
            $result | Should -Be "c:\example"
        }
    }
}

为什么普通Mock会失效？ #

简单来说，代码覆盖率检测时，Pester会重新加载并修改被测文件的字节码，让它能追踪代码执行情况。这时候被测函数调用的Read-Host是全局作用域的原生Cmdlet，而你在测试作用域里的Mock只覆盖了测试脚本的作用域，没覆盖到插桩后的被测函数所在的作用域。上面的两种方案都是让Mock的作用域覆盖到被测函数的执行环境，从而解决问题。

内容的提问来源于stack exchange，提问作者Cameron Weaver