WebView2 运行库快速部署与开发调试指南
一、WebView2 Runtime 快速安装部署
1. 系统预装情况
- Windows 11 系统默认自带常青版 WebView2 运行库,无需手动安装。
- Windows 10/7/8.1 需手动安装,缺失则调用 WebView2 控件的软件会弹窗报错「缺少 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、Python 等主流开发语言。以下是最常用的两个版本示例,均基于常青版运行库。
1. C# WinForms 极简嵌入代码
using Microsoft.Web.WebView2.WinForms;
// 第一步:在工具箱中添加 WebView2 控件并拖入窗体,命名为 webView21
private async void Form1_Load(object sender, EventArgs e)
{
// 初始化运行环境
await webView21.EnsureCoreWebView2Async(null);
// 设置网页地址或本地 HTML 文件路径
webView21.Source = new Uri("https://www.baidu.com");
}
2. C++ 基础初始化代码
#include "WebView2.h"
(, , , <ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
[hwnd](HRESULT result, ICoreWebView2Environment* env) -> HRESULT {
env->(hwnd, (...));
S_OK;
}).());


