Flutter/Dart如何直接读取文件片段为Uint8List或给readAsBytesSync加偏移？

我目前用openRead()流读取文件，因为不想用readAsBytesSync()一次性加载整个文件——有些文件高达数GB，容易触发内存异常。但处理读取的文件片段时，其他库不接受openRead()返回的List<int>，必须用Uint8List.fromList()转换，频繁转换会浪费处理时间。请问有没有办法像openRead()那样读取文件片段但直接得到Uint8List？或者能不能给不支持起始/结束偏移参数的readAsBytesSync()添加偏移功能？

解决方案 #

1. 直接读取文件片段为Uint8List（推荐） #

使用RandomAccessFile可以直接定位到指定偏移量，将字节读取到预分配的Uint8List中，全程无需额外转换，避免性能损耗：

异步实现

import 'dart:io';

Future<Uint8List> readFileSegment(String path, int start, int length) async {
  final file = File(path);
  final raf = await file.open(mode: FileMode.read);
  try {
    await raf.setPosition(start);
    final buffer = Uint8List(length);
    final bytesRead = await raf.readInto(buffer);
    // 处理文件末尾的情况：如果实际读取字节数小于指定长度，返回截断后的缓冲区
    return bytesRead == length ? buffer : buffer.sublist(0, bytesRead);
  } finally {
    await raf.close();
  }
}

同步实现

import 'dart:io';

Uint8List readFileSegmentSync(String path, int start, int length) {
  final file = File(path);
  final raf = file.openSync(mode: FileMode.read);
  try {
    raf.setPositionSync(start);
    final buffer = Uint8List(length);
    final bytesRead = raf.readIntoSync(buffer);
    return bytesRead == length ? buffer : buffer.sublist(0, bytesRead);
  } finally {
    raf.closeSync();
  }
}

这种方式直接操作底层字节缓冲区，既支持按偏移量读取片段，又不会一次性加载整个大文件，完美适配大文件场景。

2. 模拟带偏移的readAsBytesSync() #

readAsBytesSync()本身不支持偏移参数，但可以用上述RandomAccessFile的同步方法封装出类似功能，本质就是上面的readFileSegmentSync函数，调用时传入起始偏移和读取长度即可。

3. 流方式的优化（仍有转换开销） #

如果坚持使用流读取，可以自定义流转换，自动将openRead()返回的List<int>转为Uint8List，减少手动转换的重复代码：

import 'dart:io';

Stream<Uint8List> openReadAsUint8List(String path, {int? start, int? end}) {
  return File(path)
      .openRead(start, end)
      .map((chunk) => Uint8List.fromList(chunk));
}

注意：这种方式仍存在转换开销，仅推荐在必须使用流的场景下使用。

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