Blazor Hybrid 是一种将 Web 技术嵌入原生应用的开发模式，它基于 .NET 平台，结合 MAUI、WPF 或 WinForms 与 Blazor，通过内嵌 WebView 控件加载本地 Razor 组件，使用 C# 编写前端逻辑并直接调用原生 API，实现跨平台桌面和移动应用的统一开发，支持 Windows、macOS、Linux、iOS 和 Android，具备一套代码多端运行、全栈 C# 开发、离线运行等优势，适用于企业工具、数据采集类应用，需注意资源打包、路径配置和权限声明以确保正常运行。

Blazor Hybrid 是 .NET 中一种结合 Web 技术与原生桌面和移动应用的开发模式。它允许开发者使用 C#、Razor 和 HTML 构建用户界面，同时把 Web UI 嵌入到原生应用容器中，运行在 Windows、macOS、Linux、iOS 和 Android 上。

Blazor Hybrid 的工作原理

Blazor Hybrid 并不依赖浏览器或远程服务器来运行 Web 内容。它使用内嵌的 WebView 控件加载本地的 Razor 组件，并通过 .NET 运行时直接执行 C# 代码。这意味着你写的前端逻辑（如页面交互）用 C# 实现，不需要 JavaScript，同时还能调用原生平台 API。

核心框架基于：

• MAUI：用于跨平台桌面和移动应用（.NET MAUI）
• WPF 或 WinForms：用于传统的 Windows 桌面应用
• WebView2（Windows）或 Safari WebView（macOS/iOS）：渲染 Web 内容
• Blazor：提供组件化 UI 模型

如何将 Web 技术嵌入到桌面和移动应用中

通过 Blazor Hybrid，你可以把现有的 Web 开发技能迁移到原生应用开发中。以下是实现方式的关键步骤：

1. 创建 .NET MAUI 或 WPF 应用

使用 Visual Studio 或命令行创建一个 .NET MAUI 应用（支持移动端和桌面端），或一个 WPF/WinForms 应用（仅限 Windows）。例如：

dotnet new maui -n MyBlazorHybridApp

2. 添加 Blazor 支持

在项目中引入 Blazor Hybrid 包，并配置启动 Blazor 的服务。在 MainPage.xaml.cs 或应用入口中添加：

builder.Services.AddBlazorWebView();

然后在 XAML 中使用 BlazorWebView 控件：

3. 编写 Razor 组件

像开发普通 Blazor 应用一样，在项目中添加 .razor 文件。例如 Counter.razor 可以包含按钮和计数逻辑，全部用 C# 编写。

4. 调用原生功能

借助 .NET MAUI 或平台特定代码，你的 Blazor 组件可以访问文件系统、摄像头、地理位置等。例如：

@code {
    private async Task GetLocation()
    {
        var location = await Geolocation.GetLocationAsync();
        Latitude = location.Latitude;
    }
}

这些 API 在背后由原生平台实现，但暴露为统一的 C# 接口。

优势与适用场景

Blazor Hybrid 特别适合那些希望复用 Web 开发经验，又需要发布为安装包形式的应用场景。比如企业内部工具、数据采集 App、跨平台桌面客户端等。

它的主要优势包括：

• 一套代码多端运行（移动端 + 桌面端）
• 无需学习 Swift、Kotlin 或 JavaScript 框架
• C# 全栈开发，前后端语言统一
• 离线运行，不依赖网络服务器

基本上就这些。Blazor Hybrid 让 Web 技术真正“嵌入”原生外壳，既保留了开发效率，又获得了原生部署能力。不复杂但容易忽略的是：资源打包、启动路径配置和权限声明必须准确，否则 WebView 可能无法加载内容。