一、快速安装与部署
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;
}).());


