Flutter加载Assets目录CSV仅返回Future实例无法获取值咨询

你遇到的问题本质是没有正确处理Flutter的异步Future返回值，async修饰的方法默认返回Future对象，必须用await或者对应异步组件才能拿到实际返回值，不是return语句的问题。

1. 如何实现预期的读取效果 #

build方法本身是同步执行的，不能直接在build内对异步方法加await，官方推荐用FutureBuilder组件处理异步渲染逻辑，修正后的可运行代码如下：

import 'package:csv/csv.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

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

  // 抽离CSV读取逻辑，直接返回完整的CSV二维数组
  Future<List<List<dynamic>>> loadCsvData() async {
    final myData = await rootBundle.loadString("assets/class01.csv");
    return CsvToListConverter().convert(myData);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("Phonica"), elevation: 0),
      body: FutureBuilder<List<List<dynamic>>>(
        // 传入异步读取任务
        future: loadCsvData(),
        builder: (context, snapshot) {
          // 加载中状态展示
          if (snapshot.connectionState == ConnectionState.waiting) {
            return const Center(child: CircularProgressIndicator());
          }
          // 加载出错状态展示
          if (snapshot.hasError) {
            return Center(child: Text("加载失败：${snapshot.error}"));
          }
          // 加载完成后拿到实际CSV数据渲染
          final csvData = snapshot.data!;
          return ListView.builder(
            itemCount: 5,
            itemBuilder: (context, index) {
              // 可自由读取任意单元格的值
              return ListTile(title: Text(csvData[1][1].toString()));
            },
          );
        },
      ),
    );
  }
}

另外注意不要在build方法里反复调用读取CSV的方法，原代码的写法会导致每次页面重绘都重新读取一次CSV文件，造成不必要的性能浪费。

2. 从本地存储加载CSV数据时是否必须使用async #

是必须使用。Flutter提供的assets资源读取接口rootBundle.loadString本身就是异步设计，文件IO属于耗时操作，Flutter没有提供同步读取assets资源的API，所以必须用async/await或者Future回调来处理读取逻辑。

3. 更优的CSV数据加载方案 #

你目前使用的csv包是Flutter生态中最主流的CSV处理方案，没有更好的第三方库选择。可以从使用逻辑上优化：

• 如果你的App用到的CSV文件不大、数量不多，可以在App初始化阶段就把所有CSV预加载到内存中，进入对应页面直接读取内存里的数据即可，避免重复IO操作
• 如果CSV结构简单，也可以提前把CSV转成JSON格式存储在assets中，Flutter处理JSON的逻辑更通用，上手成本更低

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