avalonia不提供原生控件库，所有标准控件均为skia自绘；嵌入原生控件需用nativecontrolhost，支持winforms、gtk、cocoa等平台句柄，但需手动处理生命周期、尺寸同步及事件桥接。
Avalonia 本身不提供“原生控件库”意义上的 Avalonia Native Controls（即一套由操作系统直接渲染、非 Avalonia 自绘的 Win32/WPF/Gtk 原生控件集合），它走的是自绘（skia-based）路线，所有标准控件（Button、TextBox 等）都是 Avalonia 自己实现并跨平台一致渲染的。
真正能嵌入原生控件的方式是 NativeControlHost
若你确实需要在 Avalonia 界面中显示平台专属的原生控件（如 WinForms Control、WPF Element、或 Linux 下的 Gtk Widget），核心方案是使用：
- NativeControlHost 控件：Avalonia 官方提供的宿主容器，专用于承载各平台原生句柄（HWND、GtkWidget、NSView 等）
- 它不渲染内容，只负责生命周期管理、尺寸同步和基本消息转发
- 需手动创建原生控件，并将其平台句柄（如 WinForms.Control.Handle）赋给
NativeControlHost.Child或通过IPlatformHandle封装后设置
WinForms 嵌入典型流程（Windows）
这是最常见场景，适用于渐进式迁移：
- 在 Avalonia XAML 中放置：
<nativecontrolhost x:name="host"></nativecontrolhost> - C# 中新建 WinForms 控件（如
new Panel()或自定义 UserControl） - 调用
Control.CreateControl()获取其 HWND，并封装为IPlatformHandle - 将该 handle 赋值给
host.Child = new PlatformHandle(hwnd, "HWND") - 注意：WinForms 控件需在 UI 线程创建，且不能启用双缓冲冲突（可能需关闭
DoubleBuffered）
其他平台原生控件嵌入要点
Linux（Gtk）和 macOS（Cocoa）同样支持，但方式不同：
- Linux 下常用
Gtk.Socket+XEmbed协议嵌入外部 Gtk 应用窗口（见XEmbedSample示例） - macOS 需桥接
NSView，通过PlatformHandle传入IntPtr句柄及类型标识（如"NSView"） - 所有平台都依赖
Avalonia.Native底层对原生窗口系统的适配能力 - 事件同步（如鼠标、键盘）需额外处理：Avalonia 的
InputManager可接管，但焦点/输入法可能需手动桥接（例如 CefGlue 场景中需实现TextInputMethodClient）
别混淆：Semi.Avalonia 不是“原生控件”
像 Semi.Avalonia 这类第三方控件库，仍是基于 Avalonia 自绘体系构建的纯托管控件，样式美观、扩展性强，但并非操作系统原生控件。它只是 Avalonia 生态的增强，不是 NativeControlHost 的替代方案。
