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 控件：
<blazor:BlazorWebView HostPage="wwwroot/index.html" Services="{DynamicResource Services}" />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 可能无法加载内容。
