PAYATHON 2026

PowerShell 5.1 调用 Add-Type 加载 WebView2 程序集失败如何解决

技术问小赵

这个问题通常和 Add_Type 包装函数传错参数无关,也不是系统里的 System.Runtime.dll 损坏,更不要从第三方网站下载 DLL 来替换。报错中的 LoaderExceptions 说明:Windows PowerShell 5.1 在 .NET Framework 加载上下文中解析 Microsoft.Web.WebView2.WinForms.dll 的依赖时失败了。你引用的 Windows Performance Toolkit 目录里的这个 WebView2 程序集,并不是给 PowerShell 5.1 直接 Add-Type 加载的可靠来源;它可能按 .NET Core/.NET Standard 目标编译,并引用了 System.Runtime 4.2.1.0。

1. 先确认 LoaderExceptions

先用反射加载一次,把真正的依赖失败原因打印出来:

$fullPath = 'C:\\Program Files (x86)\\Windows Kits\\10\\Windows Performance Toolkit\\Microsoft.Web.WebView2.WinForms.dll'
try {
    [System.Reflection.Assembly]::LoadFrom($fullPath) | Out-Null
}
catch [System.Reflection.ReflectionTypeLoadException] {
    $_.Exception.LoaderExceptions | ForEach-Object { $_.Message }
}

2. 不要替换系统 DLL,改用官方依赖

  • 不要从 DLL 下载站替换 System.Runtime.dll。这不是替换单个文件就能修好的问题。
  • 先确认已安装 Microsoft Edge WebView2 Runtime;缺少运行时应从 Microsoft 官方安装 Evergreen WebView2 Runtime。
  • 开发用程序集应来自 NuGet 包 Microsoft.Web.WebView2,不要使用 Windows Performance Toolkit 里的副本。
  • 在 Windows PowerShell 5.1 中,要选择 NuGet 包里面向 .NET Framework 的目标程序集,例如 net45 或 net462,具体以包内 TFM 目录为准。

可以按下面的顺序尝试加载,注意 Core 和 WinForms 都要加载:

$pkg = Join-Path $env:TEMP 'WebView2Pkg'
# 用 nuget.exe 或 Visual Studio 的 NuGet 还原 Microsoft.Web.WebView2
$lib = Join-Path $pkg 'Microsoft.Web.WebView2\\lib\\net45'
Add-Type -Path (Join-Path $lib 'Microsoft.Web.WebView2.Core.dll')
Add-Type -Path (Join-Path $lib 'Microsoft.Web.WebView2.WinForms.dll')

如果包内没有 net45,就换成实际存在的 .NET Framework TFM。还要把与进程位数匹配的原生 WebView2Loader.dll 放到脚本目录或 PATH 中:64 位 PowerShell 用 x64,32 位 PowerShell 用 x86,路径类似 runtimes\win-x64\native\WebView2Loader.dll 或 runtimes\win-x86\native\WebView2Loader.dll。

3. 更稳的做法:用 helper 程序承载 WinForms

如果 Add-Type 仍然报依赖解析失败,建议建一个面向 net462 或 net48 的 WinForms helper 项目,通过 NuGet 引用 Microsoft.Web.WebView2,由它创建 WebView2 弹窗,PowerShell 只负责启动 helper。这样程序集依赖、原生 loader、线程模型都交给 .NET 项目处理,比在 PowerShell 5.1 里手工 Add-Type 更可靠。

4. 你的包装函数还有几个 PowerShell 问题

  • if( $WebView2Form = $true ) 是赋值,不是比较;应写成 if ($WebView2Form -eq $true),或者直接写成 if ($WebView2Form)。
  • 多行调用命令时,行尾需要反引号续行,或者把参数放在同一行:
Add_Type -fullPath 'C:\\Program Files (x86)\\Windows Kits\\10\\Windows Performance Toolkit\\Microsoft.Web.WebView2.WinForms.dll' -shortName 'WinForms.dll'
  • Write-Copy 不是标准命令;调试时用 Write-Host、Write-Output,或者直接输出 $_。
  • 函数内的 exit 会结束整个脚本,封装函数里更建议用 throw 或 return。

5. 补充:-AssemblyName 和颜色参数不是一回事

Add-Type 的 -AssemblyName 参数类型是 String[](程序集名称数组)。你的函数里应声明为 [string[]]$assemblyName;如果只允许单个名称,用 [string]$assemblyName 也可以。调用时写 -AssemblyName WinForms,这个没有 $ 前缀、也没有引号的 WinForms 会被 PowerShell 参数绑定器当成字符串实参,不是变量,也不是枚举。

Write-Host 的 -ForegroundColor Red 不一样:ForegroundColor 的类型是 [System.ConsoleColor],所以裸写 Red 会被当成枚举成员名。两者看起来相似,但底层类型不同。

还要注意:WebView2 的 WinForms 控件要求 STA 线程和消息循环;在 PowerShell 里直接承载窗口时,要确认公寓状态和进程位数匹配。

备注:内容仅供参考。