WinForm集成WebView2：打造你的自用个性化浏览器

简介：基于WebView2内核的WinForm桌面浏览器程序源码，面向C#/.NET桌面端开发者，可帮助快速打造类似Edge、Chrome的个性化浏览器，适用于需要自研内嵌浏览器、工具型客户端或定制化浏览器外壳的Windows项目。压缩包内共134个文件，约15.33MB，以dll动态库、png图标与界面资源、cs源码文件及xml配置为主，另有.sln工程与.csproj项目文件，可在Visual Studio 2019中直接打开编译。该源码完整集成WebView2内核，借助系统Edge组件完成页面渲染，同时展示WinForm窗体与浏览器控件的衔接方式，涵盖初始化配置、导航加载、资源管理、窗体大小联动等主要开发环节，便于理解桌面浏览器程序从启动到交互的完整流程。源码与配置分离，目录组织清晰，适合照着工程实践WebView2的常用API，也方便在此基础上增加收藏、下载、主题定制等个性化功能；作者还提供了配套指导文章链接，遇到编译环境问题时可直接对照。已有1097人学习下载过这份源码。

1. WinForm 加 WebView2：为什么做个自用浏览器比想象中更实用

市面上能找到的浏览器壳，要么套个 CEF 大得吓人，要么就是给浏览器加几个收藏夹。真正到了生产环境你会发现，很多桌面程序不需要整个互联网，只需要固定的几个内网系统，还要启动快、能注入自己的脚本、能接管登录状态。WinForm 加 WebView2 做一个自用个性化浏览器，就是奔着这三个需求去的。源码就在本地，改起来比改 Chromium 源码快一个量级，打包成安装程序也不复杂。这篇笔记从选型、最小实现到打包避坑，按一个完整桌面程序开发的顺序讲，适合想在自己的 Windows 机器或公司内网里快速落地一个浏览器外壳的开发者。

2. WebView2 的运行时定位与 WinForm 集成原理：选它而不是 Electron 的三个理由

2.1 WebView2 与 WebBrowser 控件的本质差异

老一批用 WinForm 做浏览器的人，上来多半被 WebBrowser 控件坑过。它包的是系统 IE 内核，默认文档模式走兼容性，CSS Grid 不认识、ES6 不支持，页面一复杂就乱版；想拦截请求、注入脚本，又要碰 COM 接口里的怪物设计。2019 年之后的 WebView2，本质是把微软的 Chromium 内核通过 COM 暴露给 Win32 应用。它不是一个单纯控件的名字，而是一套运行时加一个 SDK。控件只是个马甲，真正的页面渲染发生在独立的 browser 进程里，你的 WinForm 主进程只负责创建窗口、下发指令、接收事件。

桌面程序开发新手容易把 WebView2 当成“高级版 WebBrowser”，这是第一个理念误区。WebView2 有独立的 Runtime，它依赖 Edge 的更新通道，也可以固定版本打包。Runtime 的作用就是提供 Chromium 二进制，SDK 里的控件只是调用它的入口。理解这一点之后，你才知道部署阶段为什么要关心离线安装包、为什么要指定用户数据目录、为什么网页崩溃不会连累整个程序。WebView2 还支持多进程隔离，一个标签页崩溃，WinForm 窗体仍然能动，这比 WebBrowser 控件“一个页面卡死全院瘫痪”的体验强太多了。

2.2 为什么自用浏览器方案常常落在 WinForm + WebView2

Electron 胜在跨平台，但如果你只在 Windows 上做公司内部小工具，Electron 的个头和内存消耗常让人不爽。一个最简单的 Electron 壳，装上 Chromium、Node、V8，体积轻松超 150 MB；WinForm + WebView2 的发布产物只有几 MB，Runtime 走系统 WebView2，前提是目标机器上已经装了 Runtime。自用浏览器这类需求，用户本来就一个人或一个部门，WinForm 足够，没必要引入一套构建链。

第二个理由是好接 C# 生态。WinForm 里有现成的 NotifyIcon、TaskDialog、剪贴板、文件对话框，登录、下载、导出 Excel 都能调用本地 API。网页负责内容，桌面能力由 C# 兜底。C# WinForm MVVM 模式也能用，但不要强迫它。WinForms 的天然模型是事件驱动，你只要把 WebView2 的事件封装到自己的 ViewModel 或 Service 层，就已经比大多数人干净了。硬要在控件上绑一堆依赖属性，只会把项目写成一个四不像。

第三个理由才是“自用”的核心：源码可控。浏览器扩展对普通用户是好东西，可对要维护自己桌面程序的人来说，扩展的发布和签名流程是负担。WebView2 允许你在每次导航开始前注入脚本，在请求发出时改写 Header，在网页与 C# 之间传消息。你可以在源码里直接定义“这个站点只允许访问”，而不是去配置一个外部的扩展。对于自用个性化浏览器，这个自由度是最值钱的。

对比一下常见的三种方案：

表格里能看出来，WinForm + WebView2 在体积、可维护性、功能完整度上找到了一个平衡点。如果你要做的真是一个供几十人使用的内部工具，这个组合是最省心的。

2.3 事件模型与配置项：为个性化留的四个 Hook 点

WebView2 的 API 表面看是一堆事件，其实每一类都有对应的参数。做浏览器壳，最常用的是四个 Hook：NavigationStarting、NavigationCompleted、NewWindowRequested、WebMessageReceived。NavigationStarting 的参数里带e.Uri和e.Cancel，你可以在这里做 URL 拉黑；如果还想改请求头，用CoreWebView2.AddWebResourceRequestedFilter配合WebResourceRequested事件，能精确到某个 URL 或某个资源类型。

NavigationCompleted 可以拿到成功失败和 HTTP 状态码，适合更新地址栏、加载动画、页面出错提示。NewWindowRequested 则是浏览器里target=_blank的老大难，默认情况下 WebView2 不会自动开新窗口，你不处理，链接点了没反应。必须在这个事件里自己创建 Tab 或重定向到当前 WebView。WebMessageReceived 是留给你自己的通信通道，网页里的按钮可以通过window.chrome.webview.postMessage把数据发到 C# 端。

还有一个容易被忽略的：CoreWebView2.Settings对象。许多白屏、弹窗、右键菜单问题都出在这里。以下是常用初始化模板：

var options = new CoreWebView2EnvironmentOptions { Language = "zh-CN", AdditionalBrowserArguments = "--disable-features=msWebOOUI", TargetCompatibleBrowserVersion = "109.0.1518.46" }; var env = await CoreWebView2Environment.CreateAsync( userDataFolder: "C:\\browser-data", options: options); await webView.EnsureCoreWebView2Async(env); webView.CoreWebView2.Settings.AreDefaultContextMenusEnabled = false; webView.CoreWebView2.Settings.AreDevToolsEnabled = true; webView.CoreWebView2.Settings.IsStatusBarEnabled = false; webView.CoreWebView2.Settings.IsPasswordAutosaveEnabled = false;

这段代码在大多数 WinForm 项目里可以作为初始化模板。userDataFolder建议放在%LOCALAPPDATA%下你的应用名目录里，不要往 C 盘根目录塞；AreDevToolsEnabled在发布版里建议关掉；IsPasswordAutosaveEnabled对自用浏览器看需求，我一般关掉，登录态用 Cookie 或配置文件保持，避免浏览器把密码写进系统密码管理器，后面换机器反而迁不走。

部署阶段你要记住一个词：Evergreen。这是 Runtime 的默认分发模式，它跟着 Edge 更新，好处是安全补丁不操心，坏处是目标机器必须联网更新。如果你要给一台完全没有 WebView2 Runtime 的机器装程序，就会遇到最出名的那句“could not find the webview2 runtime”。这个问题我放到第 5 章展开，先把它归因到部署层，而不是代码层。

3. 从空目录到首屏加载：WinForm + WebView2 最小工程与导航工具条

3.1 创建项目、引入 NuGet 包和初始化

先用命令行快速建一个 WinForms 项目，比手点向导更直接：

dotnet new winforms -n MyBrowser cd MyBrowser dotnet add package Microsoft.Web.WebView2

Microsoft.Web.WebView2是微软官方维护的 SDK，VS 里用 NuGet 管理器搜索同名包也行。它会在编译时把WebView2Loader.dll和运行所需的原生资源复制到输出目录。目标框架建议net8.0-windows或更高，如果还在用 VS2015 配合 .NET Framework，也可以选net462，只是后面一些 C# 新语法要收敛一点。

然后改主窗体代码，做一个最基础的单页浏览器：

public partial class MainForm : Form { private WebView2? _webView; private TextBox _addressBox; private Button _backButton; private Button _forwardButton; private readonly string _homePage = "https://www.bing.com"; public MainForm() { InitializeComponent(); Load += MainForm_Load; BuildUI(); } private void BuildUI() { Text = "自用浏览器"; Size = new Size(1280, 800); var panel = new Panel { Dock = DockStyle.Top, Height = 42, Padding = new Padding(4) }; _addressBox = new TextBox { Dock = DockStyle.Fill, Font = new Font("Microsoft YaHei UI", 10) }; _addressBox.KeyDown += AddressBox_KeyDown; panel.Controls.Add(_addressBox); Controls.Add(_webView = new WebView2 { Dock = DockStyle.Fill }); Controls.Add(panel); Controls.SetChildIndex(_webView, 0); } private async void MainForm_Load(object sender, EventArgs e) { var env = await CoreWebView2Environment.CreateAsync( userDataFolder: Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "MyBrowser", "UserData")); await _webView!.EnsureCoreWebView2Async(env); _webView.CoreWebView2.Settings.AreDefaultContextMenusEnabled = true; _webView.CoreWebView2.Settings.IsStatusBarEnabled = false; _webView.CoreWebView2.Settings.AreDevToolsEnabled = true; _webView.Source = new Uri(_homePage); _addressBox.Text = _homePage; } }

这个初始化有几个关键点。userDataFolder一旦指定，就是这个 WebView2 实例的“浏览器配置目录”，登录 Cookie、LocalStorage、缓存都在这里。如果不传这个参数，SDK 会自动在临时目录里建一个，程序退出后不一定保留登录态。EnsureCoreWebView2Async是异步初始化，必须 await，否则后续事件和设置都会抛 InvalidOperationException。Controls.SetChildIndex(_webView, 0)保证 WebView2 先填充窗口，再让 top panel 压在它上面。

3.2 地址栏、后退、前进与刷新：命令动作和事件参数

地址栏回车导航，是浏览器最简单的交互。常见的坑是用户只输入“baidu.com”而不是完整 URL，所以要加协议补全。后退和前进按钮的状态要跟着页面历史走，不要永远可用。处理代码如下：

private void AddressBox_KeyDown(object? sender, KeyEventArgs e) { if (e.KeyCode == Keys.Enter) { Navigate(_addressBox.Text); e.SuppressKeyPress = true; } } private void Navigate(string url) { url = url.Trim(); if (string.IsNullOrEmpty(url)) return; if (!url.Contains("://")) url = "https://" + url; try { _webView!.Source = new Uri(url); } catch (UriFormatException) { _addressBox.Text = "网址格式不对"; } } private void UpdateNavButtons() { if (_webView == null || _webView.CoreWebView2 == null) return; _backButton.Enabled = _webView.CanGoBack; _forwardButton.Enabled = _webView.CanGoForward; }

在MainForm_Load里挂上这些事件：

_webView.NavigationStarting += (s, e) => { _addressBox.Text = e.Uri; UpdateNavButtons(); }; _webView.NavigationCompleted += (s, e) => { UpdateNavButtons(); if (!e.IsSuccess) { _addressBox.Text = $"加载失败：{e.HttpStatusCode}"; } }; _backButton.Click += (s, e) => _webView.GoBack(); _forwardButton.Click += (s, e) => _webView.GoForward();

事件参数e.Uri是导航目标的完整地址，注意它可能不是用户输入的那个字符串，可能被服务器重定向过，所以每次导航都同步地址栏。e.HttpStatusCode只有在完成时才有意义，跳转类响应往往不是 200，但页面能正常显示，不要在完成事件里把 3xx 当错误弹窗。

3.3 页面加载前注入脚本和样式，让网页按你的方式显示

注入脚本是“个性化”最直接的一环。比如，把网页背景改成豆沙绿护眼、给所有图片加圆角，或者在页面里挂一个全局消息桥。用AddScriptToExecuteOnDocumentCreatedAsync在每次文档创建前执行，比页面加载后再用ExecuteScriptAsync更稳定，因为前者能抢在页面自己的 JavaScript 之前跑。

string script = @" (function () { document.documentElement.style.backgroundColor = '#f2f4f7'; const style = document.createElement('style'); style.textContent = 'img { border-radius: 8px; }'; document.head.appendChild(style); window.__desktopBridge = { send: function (payload) { window.chrome.webview.postMessage(payload); } }; })(); "; string scriptKey = await _webView.CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync( "customStyle", script);

这个 API 的第一个参数是脚本唯一标识，第二个是脚本内容。它会返回一个字符串键，之后可以调用RemoveScriptToExecuteOnDocumentCreatedAsync(scriptKey)移除。脚本只在每个页面文档创建时执行一次，如果页面内部用异步加载又改了 DOM，你需要自己监听DOMContentLoaded或 MutationObserver。

还有一个控制粒度更细的 Hook：AddWebResourceRequestedFilter。比如你想屏蔽某个域名下的图片请求，可以这样写：

_webView.CoreWebView2.AddWebResourceRequestedFilter( "https://*.example.com/*", CoreWebView2WebResourceContext.All); _webView.CoreWebView2.WebResourceRequested += (s, e) => { if (e.Request.Uri.Contains("ads-example")) { e.Response = _webView.CoreWebView2.Environment.CreateWebResourceResponse( null, 204, "No Content", ""); } };

这个过滤事件会在请求发出前触发，你可以直接替换e.Response，达到广告过滤、改接口返回值的效果。注意过滤器默认走异步，如果事件处理里需要等待磁盘或网络，必须调用e.GetDeferral()，否则响应会被丢。

4. 多个标签页与用户数据隔离：把 WebView2 用成一个独立工作区

4.1 用 TabControl 管理多个 WebView2：动态创建和销毁

自用浏览器要有标签页，不然又回到一个窗口一个网页的老路。WinForm 里的 TabControl 可以直接装 WebView2，每个 TabPage 里面放一个独立的 WebView2 控件。先在建好的工程里加一个TabControl，Dock 设为 Fill，地址栏 Panel 放在它上面，然后实现动态加页。

private async void AddBrowserTab(string url) { var page = new TabPage("新标签"); var wv = new WebView2 { Dock = DockStyle.Fill }; page.Controls.Add(wv); tabControl.TabPages.Add(page); tabControl.SelectedTab = page; await wv.EnsureCoreWebView2Async(_sharedEnv); wv.CoreWebView2.Settings.IsStatusBarEnabled = false; wv.NavigationStarting += (s, e) => { string title = e.Uri; if (title.Length > 16) title = title.Substring(0, 16); page.Text = title; }; wv.Source = new Uri(url); }

这里要保证所有 Tab 共享同一个CoreWebView2Environment。如果每个 Tab 各自用EnsureCoreWebView2Async()无参重载，SDK 在内部可能会为每个控件建独立环境，Cookie 和登录态就串不起来了。正确做法是在主窗体加载时先建一个_sharedEnv，之后每个 Tab 都传同一个实例。这样 Chromium 的磁盘缓存、Cookie 存储、Service Worker 注册表都指向同一个目录，标签页之间像同一个浏览器窗口里的多个标签。

关闭标签页时，不要只把 TabPage 从集合里移除。WebView2 控件持有的浏览器内核进程和内存资源必须释放，否则程序跑一天会看到内存只涨不降。

private void CloseCurrentTab() { var page = tabControl.SelectedTab; if (page == null) return; var wv = page.Controls.OfType<WebView2>().FirstOrDefault(); wv?.Dispose(); tabControl.TabPages.Remove(page); page.Dispose(); }

Dispose会通知 WebView2 关掉它对应的浏览器进程。如果你在观察子进程，会看到那个进程的退出不是立即的，但至少托管对象不会变成内存黑洞。还有一个坑：TabPage 里可能还有别的控件，关闭前先DisposeWebView2，再Remove，否则页面上的脚本还在跑，异步回调又访问已经释放的控件，偶尔会抛 ObjectDisposedException。

4.2 共享登录态与多账号隔离：Environment 参数怎么传

第 4.1 节说共享环境是为了让标签页像同一个浏览器，但自用场景里总会有“我要同时登录两个后台账号”的需求。最简单的做法不是开两个浏览器进程，而是建另一个CoreWebView2Environment，只换userDataFolder，Cookie 和缓存立刻物理隔离。

var mainEnv = await CoreWebView2Environment.CreateAsync( Path.Combine(baseDir, "profile-main"), null); var workEnv = await CoreWebView2Environment.CreateAsync( Path.Combine(baseDir, "profile-work"), null);

把mainEnv给业务 Tab，workEnv给另一个窗口模式。这样同一个程序里会出现两个互不干扰的登录态，彼此 Session、Cookie、LocalStorage 完全独立。注意磁盘占用会翻倍，因为每个 userDataFolder 都是一套完整的 Chromium 用户数据，包含缓存和 GPU 缓存。自用机器无所谓，如果是远程桌面共享给团队用，要给每个 Profile 设配额。

如果你需要在不同环境间传递登录，比如把主环境的 Cookie 复制到工作环境，可以用CoreWebView2.CookieManager。这块属于敏感操作，我只说思路：通过GetCookiesAsync把 cookie 列表读出来，再调用AddOrUpdateCookie写入目标环境。但别把密码明文写在配置文件里，自用浏览器也别偷懒。

还有一个和 MVVM 相关的事：多个 Tab 意味着多个 WebView2 实例，WinForm 里处理这种动态子控件的惯用方法是把WebView2放进Dictionary<TabPage, WebView2>，用 TabPage 做 key。这样切换 Tab 时，你可以直接找到对应 WebView 来更新地址栏和按钮状态。没有键控表，Index 一变就会串页。

5. 打包部署避坑清单：Runtime 找不到、安装失败与图标玄学

5.1 “could not find the webview2 runtime”到底是谁的锅

在开发机上这个错不常见，因为 VS 或 Edge 已经装好了 Runtime。到了部署机，最常见的一句报错就是：

Could not find the webview2 runtime.

现象：程序一启动就弹错误框，或者窗体起来但 WebView2 区域一片空白；日志里写着找不到 WebView2 Runtime。原因很简单：目标机器没有安装 Microsoft Edge WebView2 Runtime。它可能装了 Edge 浏览器，但 Edge 的 Runtime 组件没被单独安装。解决途径有三条：一是程序安装前检测并调用 Runtime 安装器；二是采用带 Runtime 的固定版本部署；三是用命令行手动安装。对自用机器，最靠谱的是第一条，直接做进安装程序里。

检测是否已安装，可以用 registry 或者查看文件路径：

$paths = @( "C:\Program Files\WindowsApps\Microsoft.WebView2\", "C:\Program Files (x86)\Microsoft\EdgeWebView\Application\" ) $paths | ForEach-Object { Test-Path $_ }

这只是验证文件存在，严谨的检测要读版本号。但作为自用程序，能跑起来就行，别为版本匹配消耗太多时间。如果在脚本里发现路径不存在，就执行下面的离线安装包。

5.2 离线安装包与固定版本：离线机器上的兜底方案

Runtime 安装器分 Evergreen 和 Fixed Version 两种。Evergreen 版默认走在线更新，安装包小，但它会拉取当前最新 Runtime。内网离线机器装 Evergreen，如果安装包本身就是离线 installer，那依然可用，因为安装器会把所需组件全部释放到本机；真正的差别在于后续更新需要联网。固定版本则是把指定版本的 Runtime 完整目录拷贝到应用目录，程序用browserExecutableFolder指过去，更新由你控制，不会因为 Runtime 自动升级而改变行为。

离线安装器的静默安装一般是这样：

MicrosoftEdgeWebView2RuntimeInstaller.exe /silent /install

这里有个血泪教训：静默安装返回 exit code 2，几乎都是参数写错。有的脚本会在参数里加/s（小写），有的加/quiet，但这些都不是官方参数。官方正规参数是/silent和/install，大小写敏感。如果你遇到“error: installing webview2 failed with exit code 2”，先把参数改成标准形式再试。

固定版本方式在代码里是这样指定的：

var options = new CoreWebView2EnvironmentOptions { TargetCompatibleBrowserVersion = "109.0.1518.46" }; var env = await CoreWebView2Environment.CreateAsync( browserExecutableFolder: @"D:\MyBrowser\runtime\109.0.1518.46", userDataFolder: @"D:\MyBrowser\data", options: options);

当browserExecutableFolder指向一个包含msedgewebview2.exe和WebView2Loader.dll的目录时，SDK 就不会再找系统全局 Runtime。这种部署方式适合已经因为某种原因锁死内核版本的场景。注意，固定版本目录体积不小，安装包会变大，但换来的是“程序走到哪里都一样”。

5.3 用 Inno Setup 做安装包：文件和参数容易被忽略的地方

WinForm 程序打包成安装程序，常见习惯是直接写 Inno Setup 脚本，轻量、可复现。最容易的翻车点是[Files]段只拷贝了发布目录，没开recursesubdirs，导致runtimes文件夹下的原生依赖没进来；另一个是[Run]段没把 Runtime 安装器放到程序启动之前。

一个可靠的最小 Inno 脚本大概长这样：

[Setup] AppName=MyBrowser AppVersion=1.0 DefaultDirName={autopf}\MyBrowser OutputDir=.\Output OutputBaseFilename=MyBrowserSetup Compression=lzma2 SolidCompression=yes [Files] Source: ".\bin\Release\net8.0-windows\*"; DestDir: "{app}"; Flags: recursesubdirs Source: ".\tools\MicrosoftEdgeWebView2RuntimeInstaller.exe"; DestDir: "{tmp}"; Flags: deleteafterinstall [Run] Filename: "{tmp}\MicrosoftEdgeWebView2RuntimeInstaller.exe"; Parameters: "/silent /install"; Flags: waituntilterminated Filename: "{app}\MyBrowser.exe"; Description: "启动 MyBrowser"; Flags: nowait postinstall skipifsilent

几个关键点：第一个[Files]必须带recursesubdirs，把runtimes目录下各种架构的.dll都复制进去。第二个源文件是离线安装包，放到{tmp}并设置deleteafterinstall，安装完自动清理，不会污染安装目录。[Run]段的顺序很重要，Runtime 安装器必须要在启动程序之前执行。如果你把两个条目写反了，第一次启动大概率仍会闪退或白屏。

安装器在静默模式下有没有成功，Inno 脚本默认是不管返回值的。实际上也不能只看进程退出码，很多失败发生在安装之后。更稳的做法是程序第一次启动时自己调用一个 Runtime 检测 API，检测不到就给出友好提示，而不是继续崩溃。

5.4 图标、管理员权限与首次启动白屏的 3 个小题

现象一：安装完成后桌面快捷方式没有图标。原因通常是项目只设置了 WinForm 窗体的Icon，没有设置项目装配体图标，或者 Inno Setup 里的Icons段没写IconFilename。解决：在项目属性里设置 Application Icon，再在 Inno 脚本里用{app}\MyBrowser.exe作为图标源，不要单独引一个绝对路径图标文件。

现象二：程序明明装了 Runtime，但启动白屏，过几秒又能加载。原因可能是首次创建WebView2Environment时，Runtime 还要初始化 GPU 进程和网络服务，耗时较长；白屏期间没有任何 UI 反馈，看起来像卡死。解决：在EnsureCoreWebView2Async之前显示一个“初始化中...”的 Panel，完成后再隐藏；同时把AreDevToolsEnabled打开一次，直接在空白区域右键检查有没有报错。

现象三：以管理员身份运行后，WebView2 反而报找不到用户数据目录。原因是程序请求了管理员权限，Environment.SpecialFolder.LocalApplicationData指向的仍是系统管理员账户的路径，而如果安装包是用普通用户身份装的，用户数据目录没权限写。解决：不要轻易提权；如果必须提权，把userDataFolder明确设置到一个所有用户都可写的公共目录，比如C:\ProgramData\MyBrowser\UserData的子目录，并给该目录加写权限。这是我踩过一次的玄学坑，列在这里当个记性。

6. 把网页的按钮接进 C#：WebMessage 双向通道与调试日志

做自用浏览器到最后，往往不是为了上网，而是为了把网页变成桌面程序的前端。最好的办法是 WebMessageReceived 双向通道：网页里点击“导出报表”，消息送到 C#，C# 调用 Excel COM 生成文件，再通过PostWebMessageAsString把结果回传给页面。页面不用改接口，桌面端也不用心跳轮询。

一个最小 bridge 长这样：

_webView.CoreWebView2.WebMessageReceived += (s, e) => { string? message = e.TryGetWebMessageAsString(); if (message == null) return; if (message.StartsWith("save:")) { string fileName = message[5..]; File.WriteAllText(Path.Combine(@"D:\exports", fileName), "ok"); } }; await _webView.CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync( "bridge", "window.bridge = { save: (name) => window.chrome.webview.postMessage('save:' + name) };");

TryGetWebMessageAsString只能解析字符串消息，如果你在页面端发了对象，要用e.WebMessageAsJson拿原始 JSON。接收完还可以调用CoreWebView2.PostWebMessageAsString("done")把结果返回给网页，网页端监听window.chrome.webview.addEventListener('message', ...)即可。

我自己每个 WebView2 项目都会保留一个调试开关。发布版默认调低日志级别，但在开发时启动参数加--enable-logging和--v=1，就能看到 Chromium 的网络和渲染日志。这个开关在CoreWebView2EnvironmentOptions.AdditionalBrowserArguments里加，别在窗体代码里硬写。你永远不知道下一次白屏是 Runtime 没装，还是某个页面把 GPU 搞崩了。把这两样东西一起埋进初始化里，是让我少走最多弯路的一段代码。希望帮到你。

本文还有配套的精品资源，点击获取