如何使用excel包同步解码大型Excel字节文件并展示加载提示

你看到的文档说明decodeBytes method => sync is not supported指的是该方法没有提供异步重载的实现，并非不能同步执行。

实际上你当前遇到的UI卡顿，本质就是因为Excel.decodeBytes是同步执行方法。Dart的主Isolate（UI线程）同一时间只能处理一个任务，同步的大文件解码运算会阻塞整个事件循环，所有UI更新（包括等待弹窗、进度条刷新）都会被挂起直到解码完成，你只需要把解码任务移到后台Isolate运行即可实现加载提示的需求。

解决方案1：快速实现加载提示（无精确进度） #

Flutter提供了compute方法，可以快速把计算任务移到独立的后台Isolate执行，不会阻塞主UI，你可以在任务执行前后控制加载弹窗的显示和隐藏：

1. 首先定义一个顶层（或静态）的解码函数（Isolate仅支持执行无上下文依赖的顶层/静态函数）

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

Excel _decodeExcel(Uint8List bytes) {
  return Excel.decodeBytes(bytes);
}

2. 替换原有的同步解码逻辑：

// 解码前先弹出等待弹窗
showGeneralDialog(
  context: context,
  barrierDismissible: false,
  builder: (context) => const AlertDialog(
    title: Text("处理中"),
    content: LinearProgressIndicator(),
  ),
);

// 后台执行解码
Excel excel = await compute(_decodeExcel, _bytes);

// 解码完成关闭弹窗，处理业务逻辑
if (context.mounted) {
  Navigator.pop(context);
}

解决方案2：需要展示精确进度条 #

当前你使用的2.0.0-null-safety-3版本的excel包没有对外暴露解码进度的回调接口，如果你需要精确进度，可以自行修改包内解码逻辑的源码，在分片读取、解析的循环节点中插入进度回调，再通过SendPort把进度值回传给主Isolate刷新UI即可。

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