【Flutter】如何读取 excel 文件

上一篇博客介绍了文件选择器 file_picker 的用法,这一篇博文将介绍如何读取 excel 文件。

需要明确的是,Flutter 本身没有提供读取 excel 的组件,所以我们采用了社区的开源解决方案------excel

不过,写作这篇博客时的最新版(4.0.4)有一个 bug,读取 Mac Numbers 和 WPS 创建的 *.xlsx 文件时会抛出如下异常:

复制代码
_Exception (Exception: custom numFmtId starts at 164 but found a value of 41), error happens when I read an excel file using flutter excel package

针对这个问题,有人已经提了 issue,作者暂时还没解决,文章最后我会给出一个临时解决方案。

首先,新建一个页面,中间放置一个 ElevatedButton,用于读取本地 excel 文件。

然后,给按钮增加点击事件处理方法:

dart 复制代码
ElevatedButton(
  onPressed: () {
    // _pickExcelFile();
    _pickExcelFile();
  },
  child: const Text('Import'),
),

其中 _pickExcelFile 方法的实现如下:

dart 复制代码
_pickExcelFile() async {
  // 选择文件
  FilePickerResult? pickedFile = await FilePicker.platform.pickFiles(
    type: FileType.custom,
    allowedExtensions: ['xlsx'],
    allowMultiple: false,
  );

  if (pickedFile != null) {
    // 读取文件内容
    var bytes = await File(pickedFile.files.single.path!).readAsBytes();
    
    // 解析文件
    var excel = Excel.decodeBytes(bytes);
    for (var table in excel.tables.keys) {
      print(table); //sheet Name
      print(excel.tables[table]?.maxColumns);
      print(excel.tables[table]?.maxRows);
      for (var row in excel.tables[table]!.rows) {
        print('$row');
      }
    }
  }
}

一共有 3 个功能:

  1. 选取文件:

    dart 复制代码
    await FilePicker.platform.pickFiles()
  2. 读取文件:

    dart 复制代码
    await File(pickedFile.files.single.path!).readAsBytes();
  3. 解析文件:

    dart 复制代码
    var excel = Excel.decodeBytes(bytes);

以上就是读取本地 excel 文件的代码实现。

如果 excel 文件是 asset 文件,也可以用下面这种方式来读取:

dart 复制代码
_readExcelFile() async {
  ByteData data = await rootBundle.load('assets/test.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]!.maxColumns);
    print(excel.tables[table]!.maxRows);
    for (var row in excel.tables[table]!.rows) {
      print('$row');
    }
  }
}

不过要记得在 pubspec.yaml 文件中声明 asset 文件:

yaml 复制代码
assets:
  - assets/address-codes.xlsx
  - assets/test.xlsx

除了读取文件,excel 还支持创建文件:

dart 复制代码
// automatically creates 1 empty sheet: Sheet1
var excel = Excel.createExcel();

剩下的用于操作文件内容的 API 有点多,这里就不介绍了,具体可移步至 excel 文档

最后,我们来看一下如何解决文章开头提到的那个 bug。

异常代码所在的文件是 /src/parser/parse.dart

dart 复制代码
final numFmtId = int.parse(node.getAttribute('numFmtId')!);
final formatCode = node.getAttribute('formatCode')!;
if (numFmtId < 164) {
  throw Exception('custom numFmtId starts at 164 but found a value of $numFmtId');
}

问题就出在 number < 164 这个表达式上。

excel 作者貌似认为 numFmtId 小于164的所有数字格式都是内置格式,但这并不完全准确。

在Excel文件格式中,数字格式 ID 被分为两个范围:

  1. 内置数字格式:Excel提供的标准数字格式,ID 取值范围是 [0, 163]
  2. 自定义数字格式:用户自定义的数字格式,ID 从164开始,在 BIFF8/OOXML 格式中最高可达 391,在 BIFF2-BIFF7 格式中最高可达 65,535。

实际上,某些 Excel 文件可能包含 ID 低于 164 的自定义数字格式,其中包括 ID 为 0 的「常规」格式,而所谓「常规」格式实际上是一种内置格式。作者没有考虑到这一点,直接抛出了异常。

我们把上面那段代码改一下就可以了:

dart 复制代码
if (numFmtId < 164) {
  numFmtId += 164;
}

实际测试没什么问题,Mac Numbers 和 WPS 都能解析得出来。

以上就是 Flutter 中如何读取 excel 文件的实现过程,感谢阅读。

相关推荐
云心雨禅1 小时前
Vim操作指令全解析
编辑器·vim·excel
安分小尧3 小时前
[特殊字符] 使用 Handsontable 构建一个支持 Excel 公式计算的动态表格
前端·javascript·react.js·typescript·excel
hello_simon7 小时前
在线小白工具,PPT转PDF支持多种热门工具,支持批量转换,操作简单,高效适合各种需求
pdf·html·powerpoint·excel·pdf转html·excel转pdf格式
Tttian62210 小时前
Python办公自动化(3)对Excel的操作
开发语言·python·excel
bst@微胖子13 小时前
Flutter项目之登录注册功能实现
开发语言·javascript·flutter
小墙程序员15 小时前
Flutter 教程(十一)多语言支持
flutter
有趣的我15 小时前
vim的操作
编辑器·vim·excel
woniu_maggie16 小时前
SAP EXCEL DOI 详解
开发语言·后端·excel
Dickson17 小时前
如何批量拆分Excel工作表或按行拆分Excel表格 - Excel拆分器使用方法
excel·excel拆分器·拆分excel·拆分excel工作表·按行拆分excel
无知的前端17 小时前
Flutter 一文精通Isolate,使用场景以及示例
android·flutter·性能优化