在 Avalonia 中直接在 XAML 里使用 SVG 图像，核心是借助
SkiaSharp渲染引擎和 Avalonia 自带的
Image控件配合
StreamGeometry或第三方库（如
Avalonia.Svg）来实现。原生 Avalonia（v11+）不直接支持
svg文件作为
Source，但有成熟、轻量、推荐的方案。
用 Avalonia.Svg 库（最简单推荐）
这是目前社区主流、维护活跃、专为 Avalonia 设计的 SVG 支持库，支持内联 SVG、资源文件、URL 等多种方式。
安装 NuGet 包：Avalonia.Svg（注意选对版本，v11+ 推荐用
Avalonia.Svg v1.0.0+） 在
App.axaml或主窗口中添加命名空间：
XAML 中直接引用本地 SVG 文件（放在项目中并设为
Resource）：
✅ 支持缩放、颜色动态修改（通过
Fill属性）、响应式尺寸，且自动适配深色/浅色主题（若 SVG 内未硬编码颜色）。
用 StreamGeometry 手动定义简单 SVG 路径（适合图标）
如果只是少量纯路径图标（如 Material Design 图标），可将 SVG 的
d属性转为
StreamGeometry，无需外部依赖。 把 SVG 路径字符串提取出来，例如：
M12 2L2 7v10c0 5.55 3.84 9.74 9 11 5.16-1.26 9-5.45 9-11V7l-10-5z XAML 中这样写：
⚠️ 注意：只适用于无渐变、无嵌套组、无文本的纯路径图标；复杂 SVG 不适用。
加载 SVG 文件为 Bitmap（兼容但不推荐）
用
SkiaSharp在后台代码中把 SVG 解码为位图再赋给
Image.Source，适合需要严格控制渲染时机或做缓存的场景。 需引用
SkiaSharp.Svg和
SkiaSharp读取 SVG 流 → 创建
SKSvg→ 渲染到
SKSurface→ 转
Bitmap→ 绑定到控件 缺点：失去矢量缩放优势，放大可能模糊，且无法动态改色
基本上就这些。日常开发中，优先用 Avalonia.Svg 库，简洁、可靠、功能全；小图标路径可考虑
StreamGeometry；避免手动转位图，除非有特殊需求。
