使用excel包导出Flutter Excel文件时内容为空的问题求助

可能的原因及修复方案 #

1. 工作表初始化方式错误 #

部分版本的excel包中，直接通过excel['SheetName']访问未创建的工作表，可能无法正确初始化工作表对象，导致后续appendRow操作无效。建议显式创建工作表：

将：

final sheet = excel['Feed Records'];

替换为：

// 先尝试获取，不存在则创建
final sheet = excel.sheets['Feed Records'] ?? excel.createSheet('Feed Records');

2. 检查数据源是否为空 #

确认feedRecords列表是否包含有效数据。可以在循环前添加打印验证：

print('Feed records count: ${feedRecords.length}');

如果输出为0，说明没有数据可导出，需要检查数据源的获取逻辑。

3. 验证Excel包版本兼容性 #

确保使用的excel包版本是最新稳定版，旧版本可能存在appendRow或save方法的BUG。在pubspec.yaml中更新依赖：

dependencies:
  excel: ^2.0.0 # 替换为最新版本号

然后执行flutter pub get更新依赖。

4. 存储路径与权限验证（Android） #

虽然文件能创建，但部分Android版本（如13+）对外部存储的访问有更严格的限制。可以尝试将文件保存到公共下载目录：

// 使用公共下载目录（需添加permission_handler包申请权限）
final directory = await getExternalStoragePublicDirectory(DirectoryDownloads);

注意：使用公共目录需要提前申请存储权限，可通过permission_handler包实现。

修正后的完整代码 #

import 'dart:io';
import 'package:excel/excel.dart';
import 'package:path_provider/path_provider.dart';

Future<void> _exportToExcel(List<Map<String, dynamic>> feedRecords) async {
  try {
    final excel = Excel.createExcel();
    // 显式创建或获取工作表
    final sheet = excel.sheets['Feed Records'] ?? excel.createSheet('Feed Records');

    print('Feed records count: ${feedRecords.length}'); // 验证数据源

    // 添加表头
    sheet.appendRow(['Date', 'Brand', 'Size', 'Bags']);

    // 添加数据行
    for (var record in feedRecords) {
      sheet.appendRow([
        record['date'].toString(),
        record['brand'].toString(),
        record['size'].toString(),
        record['bags'].toString(),
      ]);
    }

    // 保存文件到公共下载目录
    final directory = await getExternalStoragePublicDirectory(DirectoryDownloads);
    final fileName = 'FeedRecords.xlsx';
    final filePath = '${directory.path}/$fileName';
    final fileBytes = excel.save();

    if (fileBytes != null) {
      final file = File(filePath)
        ..createSync(recursive: true)
        ..writeAsBytesSync(fileBytes);
      print('File saved at $filePath');
    }
  } catch (e) {
    print('Error exporting to Excel: $e');
  }
}

内容的提问来源于stack exchange，提问作者Richie_Eloh