Flutter多平台从Assets读取CSV的正确方式及问题排查

核心问题诊断 #

你的代码存在几个关键问题导致跨平台异常：

• 在build方法中调用异步读取逻辑：Flutter的build方法会频繁触发（如布局变化、状态更新），导致异步读取被重复执行，出现无限循环。
• 换行符检测配置错误：FirstOccurrenceSettingsDetector中的换行符写法错误，['\\r\\n', '\\n']会被解析为字面量的反斜杠，而非实际的换行符。
• 平台分支逻辑冗余且错误：Windows平台直接用File读取assets路径是错误的，Web和Android应该统一用rootBundle，Windows也可以通过rootBundle读取assets，无需单独分支。
• 状态更新时机错误：部分逻辑中状态更新没有正确触发UI刷新，且变量作用域混乱（如csvToListR在build内重新定义）。

修正后的统一实现代码 #

以下是适配安卓、Web、Windows的统一CSV读取方案，无需平台分支：

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

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

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

class HomePage extends StatefulWidget {
  const HomePage({Key? key}) : super(key: key);

  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  List<List<dynamic>> _csvData = [];
  bool _isLoading = true;

  // 统一的CSV读取方法，适配所有平台
  Future<void> _loadCSV() async {
    try {
      // 从assets读取原始字节，确保UTF-8编码正确
      final bytes = await rootBundle.load('assets/jni/sample01.jni');
      final rawData = utf8.decode(bytes.buffer.asUint8List());

      // 正确配置换行符检测
      final detector = FirstOccurrenceSettingsDetector(
        eols: ['\r\n', '\n'], // 使用实际换行符，而非转义字符串
      );

      // 解析CSV
      final csvData = CsvToListConverter(
        csvSettingsDetector: detector,
        fieldDelimiter: ';',
        shouldParseNumbers: false,
        allowInvalid: true,
      ).convert(rawData);

      setState(() {
        _csvData = csvData.transpose;
        _isLoading = false;
      });
    } catch (e) {
      setState(() {
        _isLoading = false;
      });
      print('CSV读取错误: $e');
    }
  }

  @override
  void initState() {
    super.initState();
    // 仅在初始化时调用一次读取逻辑
    _loadCSV();
  }

  @override
  Widget build(BuildContext context) {
    return SafeArea(
      child: Scaffold(
        body: _isLoading
            ? const Center(child: CircularProgressIndicator())
            : SingleChildScrollView(
                child: Column(
                  children: _csvData.map((row) {
                    return Row(
                      children: row.map((cell) {
                        return Padding(
                          padding: const EdgeInsets.all(8.0),
                          child: Text(cell.toString()),
                        );
                      }).toList(),
                    );
                  }).toList(),
                ),
              ),
      ),
    );
  }
}

关键优化点说明 #

• 统一用rootBundle.load读取字节：避免不同平台的编码差异，手动用utf8.decode确保编码正确，解决你提到的UTF-8转换需求。
• 将读取逻辑移到initState：确保仅执行一次，避免build重复调用导致的无限循环。
• 修正换行符配置：把['\\r\\n', '\\n']改为['\r\n', '\n']，让检测器能正确识别换行符，解决仅读取第一行的问题。
• 添加加载状态：优化用户体验，同时避免未加载完成时UI异常。
• 移除冗余平台分支：RootBundle是Flutter统一的资源读取方式，所有平台都支持读取assets目录下的文件，无需单独处理Windows的File读取。

额外注意事项 #

1. 确保pubspec.yaml中正确配置了assets路径：

flutter:
  assets:
    - assets/jni/sample01.jni

2. 若CSV文件编码不是UTF-8，需对应调整解码方式（如gbk需使用dart:convert的gbk解码库）。
3. 避免在build方法中执行异步操作或状态更新，这是Flutter性能和逻辑异常的常见原因。

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