Avalonia需借助EPPlus或NPOI导出Excel，核心是获取ItemsSource绑定的IEnumerable数据源，映射字段后写入工作表并保存；注意处理中文编码、日期格式、空值及大数据量性能优化。
Avalonia 本身不内置 Excel 导出功能，需借助第三方库（如 EPPlus 或 NPOI）将 DataGrid 绑定的数据源导出为 .xlsx 文件。关键在于：获取数据源（通常是 IEnumerable）、映射字段、写入工作表，最后保存文件。
获取 DataGrid 的原始数据源
DataGrid 的数据通常来自 ItemsSource，它可能是 ObservableCollection、List 或其他可枚举集合。避免直接操作 UI 行（如 DataGrid.Items），而应从 ViewModel 或绑定源中提取干净数据：
- 确保 ViewModel 中暴露了可导出的数据集合（例如
public ObservableCollection
People { get; } = new(); - 若使用
DataGrid.ItemsSource 绑定到表达式（如{Binding FilteredItems}），导出时也应调用同一属性获取最新数据 - 注意处理筛选/排序后的视图——如果需要导出当前显示内容，且使用了
ICollectionView（如CollectionViewSource），应遍历其Cast结果而非原始源()
使用 EPPlus 写入 Excel（推荐 .NET 6+）
red">注意：EPPlus 6+ 需要商业许可用于企业用途；个人/开源项目可免费使用。也可选用 MIT 协议的 NPOI（更轻量但 API 略冗长）。
安装 NuGet 包：Install-Package EPPlus
示例代码（导出到本地文件）：
- 创建
ExcelPackage实例 - 添加工作表，设置标题行（取自 T 的
PropertyInfo.Name或自定义特性） - 逐行写入数据（支持值类型、字符串、日期等；跳过复杂对象或委托）
- 调用
SaveAsAsync(fileStream)保存，配合 Avalonia 的OpenFileDialog获取保存路径
处理常见问题
导出过程容易忽略的细节：
- 中文乱码：EPPlus 默认 UTF-8，无需额外设置；确保 Excel 应用以 UTF-8 打开（现代 Excel 通常自动识别）
-
日期格式错乱：写入
DateTime后，显式设置单元格样式：worksheet.Cells[row, col].Style.Numberformat.Format = "yyyy-mm-dd hh:mm:ss"; -
空值/Null 异常：写入前判空，例如
cell.Value = item.Property?.ToString() ?? ""; -
性能优化：大数据量（>1w 行）建议关闭自动计算、禁用公式重算：
package.Workbook.CalculateMode = OfficeOpenXml.ExcelCalculationMode.Manual;
封装成可复用的导出方法
建议在 ViewModel 或工具类中封装通用导出逻辑，例如：
- 接收
IEnumerable和列名映射（支持[Display(Name = "...")]特性） - 支持异步导出 + 进度通知（通过
IProgress） - 返回
Task表示是否成功，并在 UI 层弹出提示（如DialogHost.Show(...)） - 与 Avalonia 的
StorageProvider集成，调用系统保存对话框
