一、WebView2 Runtime 快速安装部署(用户 / 开发通用,必做)
✅ 1. 系统预装情况
- Windows 11 系统 默认自带 常青版 WebView2 运行库,无需手动安装;
- Windows 10/7/8.1 需手动安装,缺失则调用 WebView2 控件的软件会弹窗报错「缺少 WebView2 运行环境」。
✅ 2. 两种官方安装方式(推荐)
方式 1:常青版(Evergreen Runtime)- 首选
- 特点:体积小(引导包仅 2MB),自动和 Edge 浏览器同步更新,共享内核组件,极低资源占用,所有软件共用 1 个运行库,永久适配新版网页标准。
- 安装:微软官网搜索「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」主流开发语言,以下是最常用 2 个版本示例,复制即用,均基于常青版运行库。
1. C# WinForms 极简嵌入代码(使用率最高)
using Microsoft.Web.WebView2.WinForms;
// 第一步:工具箱添加 WebView2 控件拖入窗体,命名为 webView21
private async void Form1_Load(object sender, EventArgs e)
{
// 初始化运行环境,加载指定网页/本地 HTML
await webView21.EnsureCoreWebView2Async(null);
webView21.Source = new Uri("https://www.baidu.com"); // 网页地址/本地 HTML 文件路径均可
}
2. C++ 基础初始化代码
#
(, , , <ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
[hwnd](HRESULT result, ICoreWebView2Environment* env) -> HRESULT
{
env->(hwnd, (...));
S_OK;
}).());


