Microsoft Edge WebView2 Runtime 运行库快速部署与调试指南

WebView2 运行库快速安装部署（用户 / 开发通用）

一、系统预装情况

• Windows 11 系统默认自带常青版 WebView2 运行库，无需手动安装；
• Windows 10/7/8.1 需手动安装，缺失则调用 WebView2 控件的软件会弹窗报错「缺少 WebView2 运行环境」。

二、两种官方安装方式（推荐）

方式 1：常青版（Evergreen Runtime）- 首选

• 特点：体积小（引导包约 2MB），自动和 Edge 浏览器同步更新，共享内核组件，资源占用低，所有软件共用 1 个运行库，适配新版网页标准。
• 安装：微软官网搜索「Microsoft Edge WebView2 Runtime 常青版」，下载后双击默认安装即可。

方式 2：固定版本（Fixed Version）- 开发专用

• 特点：独立完整包，不自动更新，版本固定，适合开发打包软件时捆绑分发，避免用户环境版本不一致导致兼容问题。
• 适用：做软件分发的开发者，可将该版本嵌入安装包，实现软件 + 运行库一体安装。

三、关键部署须知

• 运行库无独立界面，安装后在后台静默运行，不会修改系统默认浏览器，不占用桌面空间；
• 与 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;
private async void Form1_Load(object sender, EventArgs e)
{
    await webView21.EnsureCoreWebView2Async(null);
    webView21.Source = new Uri("https://www.baidu.com");
}

2. C++ 基础初始化代码

#include "WebView2.h"
CreateCoreWebView2EnvironmentWithOptions(nullptr, nullptr, nullptr, Callback<ICoreWebView2CreateCoreWebView2EnvironmentCompletedHandler>(
    [hwnd](HRESULT result, ICoreWebView2Environment* env) -> HRESULT {
        env->(hwnd, (...));
         S_OK;
    }).());