Microsoft Edge WebView2 Runtime 部署与调试指南

一、快速安装与部署

WebView2 Runtime 是微软提供的基于 Chromium 内核的组件，允许在原生 Windows 应用中嵌入网页内容。对于用户和开发者来说，正确安装和配置它是基础。

1. 系统预装情况

Windows 11 系统默认自带常青版（Evergreen）WebView2 运行库，通常无需手动干预。但在 Windows 10、7 或 8.1 上，如果缺失该环境，调用 WebView2 控件的软件可能会报错提示缺少运行库。

2. 两种官方安装方式

方式 1：常青版（Evergreen Runtime）

这是首选方案。引导包体积很小（约 2MB），会自动与 Edge 浏览器同步更新，共享内核组件。所有软件共用一个运行库，资源占用极低，且能永久适配新版网页标准。

• 操作：访问微软官网搜索 "Microsoft Edge WebView2 Runtime 常青版"，下载后双击安装即可，全程静默无弹窗。

方式 2：固定版本（Fixed Version）

适合开发场景。这是一个独立完整包，不自动更新，版本固定。主要用途是在打包分发软件时捆绑该版本，确保目标用户环境的版本一致性，避免兼容性问题。

3. 关键部署须知

• 运行库没有独立界面，安装后在后台静默运行，不会修改系统默认浏览器设置。
• 与 Edge 浏览器共享 Chromium 内核组件，大幅节省磁盘和内存空间。
• 支持从 Windows 7 SP1 到 Windows 11 的全系统范围，32 位和 64 位均兼容。

二、开发基础嵌入示例

WebView2 支持 C# (WinForms/WPF)、C++、VB.NET 等主流语言。以下提供两个最常用的代码片段，基于常青版运行库编写。

1. C# WinForms 极简嵌入

这是使用率最高的场景。首先需要在 NuGet 中安装 Microsoft.Web.WebView2 包，然后将控件拖入窗体。

using Microsoft.Web.WebView2.WinForms;

// 假设窗体上已添加名为 webView21 的控件
private async void Form1_Load(object sender, EventArgs e)
{
    // 初始化运行环境
    await webView21.EnsureCoreWebView2Async(null);
    
    // 加载网页或本地 HTML 文件
    webView21.Source = new Uri("https://www.baidu.com");
}

注意：EnsureCoreWebView2Async 是异步方法，建议在 Load 事件中调用。Source 属性既可以是远程 URL，也可以是本地文件路径。

2. C++ 基础初始化

C++ 开发需要引用官方 SDK，并处理回调逻辑。

#include "WebView2.h"

// 初始化 WebView2 环境，绑定窗口句柄
(
    ,
    ,
    ,
    <ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
        [hwnd](HRESULT result, ICoreWebView2Environment* env) -> HRESULT {
             ((result) && env) {
                env->(hwnd, ...);
            }
             S_OK;
        }).());