Avalonia 目前官方不支持 WebAssembly，因其依赖本地图形 API 和系统窗口管理，而 WASM 运行在沙箱中无法访问原生窗口、绘图上下文等资源；替代方案包括 Blazor WebAssembly、Uno Platform 或 Avalonia+WebView2 混合架构。
Avalonia 目前官方不支持 WebAssembly，也没有计划在短期内原生支持 WASM 运行时。它是一个面向桌面（Windows/macOS/Linux）和移动端（Android/iOS，通过 Avalonia.Native 或社区绑定）的跨平台 UI 框架，底层严重依赖本地图形 API（如 Skia、Direct2D、Metal、OpenGL）和系统级窗口管理，而这些在浏览器 WASM 环境中不可用或受限。
为什么 Avalonia 不能直接跑在 WASM 上
WebAssembly 是一个安全、沙箱化的二进制指令格式，运行在浏览器中，无法直接访问：
- 原生窗口系统（无 HWND、NSWindow、X11 窗口句柄）
- 系统级绘图上下文（如 Direct2D、Metal、Vulkan）
- 文件系统、注册表、设备 I/O 等敏感 API（除非通过 JS 代理且用户授权）
- 线程模型受限（WASM 主线程为主，Pthreads 支持有限且需显式启用）
Avalonia 的渲染管线（基于 Skia 或 DirectX/Metal 后端）、输入事件分发、布局调度等都假设存在一个“原生宿主环境”，这与浏览器环境本质冲突。
当前可行的替代方案（不是 Avalonia for WASM，但解决类似需求）
如果你的目标是“用 C# 写 UI，并部署到网页”，可考虑以下成熟路径：
- Blazor WebAssembly：微软官方方案，C# + Razor 组件 + .NET 运行时编译为 WASM。UI 基于 HTML/CSS/JS 渲染，天然适配浏览器。适合企业后台、数据应用、轻量交互界面。
- Uno Platform：支持 WebAssembly（通过 WebAssembly AOT + SkiaSharp 渲染），API 兼容 UWP/WinUI。可用 XAML 编写 UI，一套代码输出 Web、iOS、Android、Windows。对熟悉 XAML 生态的开发者友好。
- Avalonia + WebView2（桌面端嵌入 Web）：在 Avalonia 桌面应用中嵌入 WebView2 控件，把部分 UI（如报表、文档、图表）用 Web 技术实现。这不是“Avalonia 跑在 WASM”，而是混合架构。
社区实验性尝试（不推荐用于生产）
过去有极少数实验项目尝试将 Avalonia 渲染层桥接到 Canvas 2D 或 WebGL（例如通过 SkiaSharp + WebAssembly + JS Interop），但存在严重问题：
- 性能差（大量托管对象与 JS 互操作开销）
- 输入事件丢失或延迟（鼠标/键盘事件需手动映射）
- 无焦点管理、剪贴板、拖放、缩放等基础能力
- 维护停滞，不兼容新版 Avalonia 和 .NET SDK
这类项目（如早期 avalonia-web 或 skia-wasm-demo）仅具技术验证价值，不应作为项目选型依据。
如果必须用 Avalonia，目标平台就应明确为桌面或移动原生；如果目标是 Web，建议直接采用 Blazor 或 Uno Platform。两者都有活跃社区、完善文档和生产案例，能真正落地。
