Flutter如何从Asset Bundle中读取超长文件为字符串？

你遇到的“读取到一半内容中断”90%以上不是读取API的问题，是下面几个常见坑，按优先级排查： #

1. 第一优先级排查：控制台打印的日志截断 #

Flutter的print()方法、IDE的debug控制台对单条日志有固定长度限制，Android Studio、VS Code默认单条日志输出上限在800~2000字符区间，超过长度的部分会直接被截断不显示。不要靠控制台打印的内容判断文件是否读取完整，这是Flutter开发里最容易踩的日志坑——你看到的“内容断了”只是打印的时候没输出全，内存里实际拿到的文件内容是完整的。

验证方式很简单，不要直接打印全量字符串，先打印读取内容的总长度，和你本地原文件的字符数做对比：

import 'package:flutter/services.dart';
import 'dart:convert';

rootBundle.loadString('assets/json/quotes.json').then((value) {
  // 对比长度判断是否真的读全
  print('读取内容总长度：${value.length}');
  // 直接在回调内做反序列化，不要靠打印出的内容判断完整性
  final quoteData = jsonDecode(value);
});

如果打印的长度和本地原文件字符数一致，说明文件已经完整读取，之前反序列化失败是JSON本身格式问题（比如多余的尾逗号、未转义的特殊字符、引号不匹配），和读取逻辑无关。

如果确实需要打印全量长文本排查问题，用分段打印的方法绕开日志长度限制：

void printFullLog(String content) {
  // 每次打印800字符，规避单条日志长度上限
  final chunkReg = RegExp('.{1,800}');
  chunkReg.allMatches(content).forEach((match) => print(match.group(0)));
}

2. 排查资产配置和缓存问题 #

如果打印的长度确实和原文件不一致，说明文件没被正确打包进安装包：

• 检查pubspec.yaml里的资产路径配置，路径大小写要和实际目录完全匹配：

flutter:
  assets:
    # 单文件注册写法
    - assets/json/quotes.json
    # 注册整个目录的写法（二选一即可）
    - assets/json/

• 改完pubspec配置、或者替换过assets目录下的文件之后，必须停止当前运行的App，执行flutter clean清除构建缓存，再全量编译运行。热重载、热重启都不会更新assets目录的打包内容，会一直读取旧的缓存文件。

3. 特殊编码兼容处理 #

如果你的JSON文件带BOM头、或者包含特殊UTF-8字符，用load方法手动做解码，注意要传入正确的偏移和长度参数，避免读到内存块里的无效数据——你之前写的第二种读取方案就漏了这两个参数，可能会把内存块里不属于当前文件的冗余数据读进来，导致解析失败：

import 'package:flutter/services.dart';
import 'dart:convert';
import 'dart:typed_data';

rootBundle.load('assets/json/quotes.json').then((data) {
  // 必须传offset和length参数，仅读取当前文件对应的内存片段
  final Uint8List fileBytes = data.buffer.asUint8List(
    data.offsetInBytes,
    data.lengthInBytes
  );
  final String content = utf8.decode(fileBytes);
  final quoteData = jsonDecode(content);
});

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