Flutter新手求助：assets目录Excel文件导入代码问题排查

问题描述 #

我是Flutter新手，在逻辑实现方面遇到了困难。我希望导入放置在assets文件夹中的Excel文件，提取数据供应用的各个页面使用。我了解到有多个处理Excel文件的包，其中excel包看起来是最佳选择，但我不清楚应该将代码放置在何处。我的应用整体可正常运行，但在导入Excel文件时出现问题。以下是我在main.dart文件中编写的代码：

import 'dart:io';
import 'package:path/path.dart';
import 'package:flutter_excel/excel.dart';
import 'package:flutter/services.dart' show ByteData, rootBundle;

Future<void> importExcelFile() {
  ByteData data = await rootBundle.load("assets/existing_excel_file.xlsx");
    var bytes = data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes);
    var excel = Excel.decodeBytes(bytes);
        
    for (var table in excel.tables.keys) {
      print(table); //sheet Name
      print(excel.tables[table].maxCols);
      print(excel.tables[table].maxRows);
      for (var row in excel.tables[table].rows) {
        print("$row");
      }
    }
}

void main() async {
  importExcelFile();
  print('Import ok...');

  runApp(const MainApp({super.key}));
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: MainMenu(),
    );
  }
} 

错误点分析 #

1. 异步函数缺少标记：importExcelFile函数内使用了await，但未在函数声明中添加async关键字，直接导致语法错误。
2. 未等待异步操作完成：main函数中调用importExcelFile()时没有加await，会导致"Import ok..."在Excel文件加载解析完成前就打印，同时无法捕获异步操作中的异常。
3. 构造函数调用语法错误：runApp(const MainApp({super.key}));写法错误，类的构造函数已定义{super.key}可选参数，调用时无需重复传递，直接写const MainApp()即可。
4. 可能未配置Assets路径：如果没有在pubspec.yaml中声明该Excel文件的assets路径，rootBundle.load会找不到文件，导致加载失败。

修正后的代码 #

main.dart #

import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show ByteData, rootBundle;
import 'package:excel/excel.dart'; // 注意包名是excel，不是flutter_excel

Future<void> importExcelFile() async { // 添加async关键字
  try {
    ByteData data = await rootBundle.load("assets/existing_excel_file.xlsx");
    var bytes = data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes);
    var excel = Excel.decodeBytes(bytes);
        
    for (var table in excel.tables.keys) {
      print(table); // sheet名称
      print(excel.tables[table]?.maxCols);
      print(excel.tables[table]?.maxRows);
      for (var row in excel.tables[table]?.rows ?? []) {
        print("$row");
      }
    }
    print('Import ok...'); // 移到异步操作完成后打印
  } catch (e) {
    print('Excel加载失败: $e'); // 捕获异常，方便排查问题
  }
}

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保Flutter绑定初始化，避免异步操作提前执行
  await importExcelFile(); // 等待Excel加载完成
  runApp(const MainApp());
}

class MainApp extends StatelessWidget {
  const MainApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: const MainMenu(), // 假设MainMenu是已定义的页面组件
    );
  }
}

// 示例MainMenu组件（如果未定义）
class MainMenu extends StatelessWidget {
  const MainMenu({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('主菜单')),
      body: const Center(child: Text('Excel加载完成')),
    );
  }
}

pubspec.yaml配置 #

确保在pubspec.yaml中添加Assets声明：

flutter:
  uses-material-design: true
  assets:
    - assets/existing_excel_file.xlsx # 声明你的Excel文件路径

注意事项 #

• 确认Excel文件确实放在项目根目录下的assets文件夹中，路径与代码和pubspec配置一致。
• 如果需要在多个页面使用解析后的Excel数据，可以将数据存储在全局状态管理工具中（如Provider、GetX等），或者通过构造函数传递给子页面。
• 异步操作建议放在WidgetsFlutterBinding.ensureInitialized()之后执行，避免在Flutter初始化完成前调用平台相关API。

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