WebView2 运行前必须安装 WebView2 Runtime 或 Edge 浏览器；它不自带渲染引擎，依赖系统级 Microsoft Edge WebView2 Runtime 或已安装的 Edge（Chromium 内核），否则抛出 CoreWebView2InitializationException。
WebView2 运行前必须安装 WebView2 Runtime 或 Edge 浏览器
WebView2 不自带渲染引擎，它依赖系统级的 Microsoft Edge WebView2 Runtime（或已安装的 Edge 浏览器）。如果目标机器没装 Edge（Chromium 内核）或未单独安装 MicrosoftEdgeWebView2Runtime，CoreWebView2InitializationException 会直接抛出，且错误信息常被误读为“控件初始化失败”。
实操建议：
- 开发时在项目中引用
Microsoft.Web.WebView2NuGet 包（推荐最新稳定版，如1.0.2920.47及以上） - 部署时优先引导用户安装离线 Runtime：从 WebView2 官方下载页 获取
WebView2RuntimeInstaller.exe，静默安装命令为：WebView2RuntimeInstaller.exe /silent /install - 代码中应捕获初始化异常，并提示明确信息，例如检查
Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData) + @"\Microsoft\EdgeWebView"是否存在可用运行时版本
WPF 中用 WebView2 控件需启用 WebView2 的预发布支持（.NET 6+）
.NET 6 起，WPF 原生支持 WebView2 控件（Microsoft.Web.WebView2.Wpf.WebView2），但需确认项目 SDK 和目标框架匹配。常见问题是：明明装了包，XAML 里却报 The tag 'WebView2' does not exist in XML namespace。
原因和解决：
- 确保项目文件使用
<Project Sdk="Microsoft.NET.Sdk">（而非旧式csproj格式） - TargetFramework 必须为
net6.0-windows或更高（如net8.0-windows），且含-windows后缀——这是 WPF 桌面 API 的必要标识 - XAML 命名空间要写对：
xmlns:wv2="clr-namespace:Microsoft.Web.WebView2.Wpf;assembly=Microsoft.Web.WebView2.Wpf" - 首次加载前必须调用
EnsureCoreWebView2Async()，否则Source赋值无效；建议在Loaded事件中执行，而非构造函数
WinForms 中初始化 WebView2 必须手动创建 CoreWebView2Environment
WinForms 的 WebView2 控件（Microsoft.Web.WebView2.WinForms.WebView2）不自动推导运行时路径，尤其在自定义缓存目录或需要指定 Edge 安装路径时，容易卡在空白页或报 HRESULT: 0x80070002（找不到文件）。
关键步骤：
- 不要直接 new 控件后就设
Source；先 awaitEnsureCoreWebView2Async()，但该方法内部需已有环境上下文 - 推荐显式创建环境：
var env = await CoreWebView2Environment.CreateAsync(browserExecutableDir: @"C:\Program Files\Microsoft\Edge\Application")，再传入InitializeAsync(env) - 若想复用用户 Edge 的个人资料（如保存 Cookie），可传入
userDataFolder参数指向一个可写的本地路径，例如：Path.Combine(Application.LocalUserAppDataPath, "WebView2UserData") - 注意：WinForms 控件的
CoreWebView2InitializationCompleted事件比Initialized更可靠，前者保证CoreWebView2已就绪，后者可能在失败时也触发
调试 WebView2 页面时，DevTools 不会自动弹出，得手动启用
很多开发者以为右键“检查元素”能唤出 DevTools，但 WebView2 默认禁用该功能。页面出错时看不到 console 日志，JS 断点也无法下，排查效率骤降。
启用方式分两种场景：
- 开发阶段：在初始化完成后调用
webView.CoreWebView2.OpenDevToolsWindow()（WPF/WinForms 均支持），可绑定到某个快捷键或按钮 - 发布阶段：通过启动参数控制，例如在
CreateAsync()时传入additionalBrowserArguments: "--remote-debugging-port=9222"，然后用 Chrome 访问http://localhost:9222 - 注意：DevTools 窗口是独立进程，关闭它不会影响 WebView2 主体；但若在调试中刷新页面，需重新打开 DevTools 才能捕获新上下文
真正麻烦的是跨进程通信场景——比如用 CoreWebView2.AddWebMessageReceivedHandler() 接收 JS 消息时，若 JS 抛了异常没 catch，错误不会透出到 C# 层，只能靠 DevTools 的 Console 面板发现。
