Avalonia 无内置 WebView,推荐使用跨平台的 Avalonia.WebView:Windows 基于 WebView2,macOS 基于 WKWebView,Linux 基于 WebKitGTK;需安装对应 NuGet 包、注册服务、声明控件,并配置平台依赖及 JS 互调。

Avalonia 本身不内置 WebView 控件(如 WPF 的 WebView2 或 UWP 的 WebView),但可通过第三方绑定或原生互操作方式集成浏览器内核。目前主流、稳定且跨平台支持较好的方案是使用 Avalonia.WebView(基于 WebView2 的 Windows + WebViewGTK / WebKitGTK 的 Linux + WebView2/macOS 的 macOS 支持)或更轻量的 Avalonia.Skia.WebView(实验性,基于 Skia 渲染 HTML)。不过生产环境推荐使用官方社区维护较活跃的 Avalonia.WebView。
使用 Avalonia.WebView(推荐)
这是目前 Avalonia 生态中较成熟、跨平台(Windows/macOS/Linux)的 WebView 绑定库,底层在不同平台自动桥接对应原生 WebView:
- Windows:基于 Microsoft Edge WebView2(需系统安装 Edge 运行时或嵌入 SDK)
- macOS:基于 WKWebView(系统自带,无需额外依赖)
- Linux:基于 WebKitGTK(需系统安装 libwebkit2gtk-4.1 或对应版本)
使用步骤:
- 安装 NuGet 包:
Avalonia.WebView(注意匹配 Avalonia 主版本,如Avalonia 11.x对应Avalonia.WebView 11.x) - 在
App.xaml.cs的OnFrameworkInitializationCompleted中注册服务(Windows 需初始化 WebView2):
(Windows 示例)
if (RuntimePlatform.IsWindows)
{
await WebView2Runtime.InitializeAsync();
}在 XAML 中声明控件:
支持基本导航、JS 互调(ExecuteScriptAsync)、自定义用户代理等。
Linux 下注意事项(WebKitGTK)
Linux 平台依赖 WebKitGTK,若运行时报错“Failed to load webkit2gtk”,需确保系统已安装:
- Ubuntu/Debian:
sudo apt install libwebkit2gtk-4.1-dev - Fedora/RHEL:
sudo dnf install webkit2gtk4.1-devel - Arch:
sudo pacman -S webkit2gtk
同时确认应用运行时有图形环境(X11/Wayland)和 GL 上下文支持(Avalonia 默认使用 Skia+GL 后端)。
替代方案:简单 HTML 渲染(无 JS)
若仅需展示静态 HTML/CSS(不执行 JS、不交互),可考虑:
- Avalonia.HtmlRenderer(社区项目,基于 AngleSharp + Skia 渲染,轻量但功能有限)
- 用
TextBlock+ 自定义 HTML 解析器(仅适用于极简场景)
这类方案无法替代完整 WebView,但适合嵌入帮助文档、Markdown 预览等只读内容。
JS 与 C# 通信(关键能力)
Avalonia.WebView 支持双向通信:
- C# 调用 JS:
await webView.ExecuteScriptAsync("alert('Hello from C#');"); - JS 调用 C#:
webView.RegisterScriptObject("bridge", new JsBridge());,然后在 JS 中访问window.bridge.invoke(...)
注意:对象需标记 [AllowForWeb],方法需为 public async Task,并返回 Task 或 Task。
基本上就这些。选对绑定库、配好平台依赖、注意 JS 通信的安全边界,就能在 Avalonia 中稳稳用上 WebView。










