Flutter Web 2.10如何读写txt、xlsx等格式的本地文件

Flutter Web 运行在浏览器沙箱环境中，完全不支持dart:io库的File类及相关本地文件系统API，这是你之前代码失效、网上旧方案跑不起来的核心原因——凡是依赖dart:io做文件操作的方案，从设计上就不支持Web端，不存在“过时失效”的问题。
Web端的文件操作逻辑和桌面/移动端完全不同，所有读写都是基于内存字节流+浏览器API实现，没有真实的本地文件路径可供访问，你之前直接把文本读成字符串解析的思路方向是对的，只是没有用标准的封装实现而已。

前置依赖配置 #

在pubspec.yaml里添加以下适配Flutter 2.10的依赖版本，避免版本冲突：

dependencies:
  file_picker: 4.6.1 # 兼容2.10的文件选择器，Web端原生支持
  excel: 2.0.1 # Excel解析库，纯Dart实现不依赖本地IO

TXT文件读取标准实现 #

不需要转成dart:io的File对象，拿到文件字节后直接解码即可，这是Web环境下的官方标准实现，不属于临时不规范方案：

import 'dart:convert';
import 'dart:typed_data';
import 'package:file_picker/file_picker.dart';

Future<List<String>?> readTxtLines() async {
  // 限定选择txt格式文件
  FilePickerResult? result = await FilePicker.platform.pickFiles(
    type: FileType.custom,
    allowedExtensions: ['txt'],
    withData: true, // Web端必须开启，才会返回文件的内存字节
  );
  if (result == null) return null;

  final Uint8List fileBytes = result.files.first.bytes!;
  // 直接解码字节为文本，按行拆分即可等价实现readAsLines()效果
  final String fileContent = utf8.decode(fileBytes);
  return fileContent.split(RegExp(r'\r?\n'));
}

Excel文件读取标准实现 #

直接把拿到的文件字节传给Excel解析库即可，完全不需要本地文件读写权限：

import 'dart:typed_data';
import 'package:file_picker/file_picker.dart';
import 'package:excel/excel.dart';

Future<Excel?> readExcel() async {
  FilePickerResult? result = await FilePicker.platform.pickFiles(
    type: FileType.custom,
    allowedExtensions: ['xlsx', 'xls'],
    withData: true,
  );
  if (result == null) return null;

  final Uint8List fileBytes = result.files.first.bytes!;
  // 直接解码字节为Excel对象，后续可读取工作表、单元格内容
  final Excel excelDoc = Excel.decodeBytes(fileBytes);
  
  // 示例：遍历第一个工作表的所有行
  for (final row in excelDoc.tables.values.first.rows) {
    print(row.map((cell) => cell?.value).toList());
  }
  return excelDoc;
}

Web端文件保存（写入）实现 #

Web端没有直接写入用户本地文件系统的权限，保存文件本质是触发浏览器原生下载：

import 'dart:convert';
import 'dart:html' as html;
import 'package:excel/excel.dart';

// 保存TXT文件到本地
void saveTxt(String content, String saveFileName) {
  final fileBytes = utf8.encode(content);
  final blob = html.Blob([fileBytes]);
  final objectUrl = html.Url.createObjectUrlFromBlob(blob);
  html.AnchorElement(href: objectUrl)
    ..download = saveFileName
    ..click();
  html.Url.revokeObjectUrl(objectUrl);
}

// 保存Excel文件到本地
void saveExcel(Excel excelDoc, String saveFileName) {
  final fileBytes = excelDoc.encode()!;
  final blob = html.Blob([fileBytes]);
  final objectUrl = html.Url.createObjectUrlFromBlob(blob);
  html.AnchorElement(href: objectUrl)
    ..download = saveFileName
    ..click();
  html.Url.revokeObjectUrl(objectUrl);
}

注意事项 #

• 如果读取txt文件出现乱码，可根据文件实际编码替换解码逻辑，比如GBK编码文件可引入gbk编解码库处理
• 浏览器安全策略限制下，Web端无法主动写入用户本地任意路径，所有保存操作必须由用户点击触发
• 你之前编写的错误代码核心问题是误用了仅支持桌面/移动端的File.fromRawPath方法，该API在Web环境下永远无法正常运行

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