Dart/Flutter中能否将所有控制台输出写入变量？

要完整收集Flutter应用的所有控制台输出（包括不同Isolate的日志、框架错误、第三方库输出），仅靠runZoned确实不够，需要结合几种方式来实现：

1. 重定向顶层print和debugPrint #

Flutter的print是顶层函数，可以通过Zone重定向它的输出，同时保留原控制台打印方便本地调试：

final logBuffer = StringBuffer();

void main() {
  // 重定向print输出到缓冲区
  Zone.current.print = (String line) {
    logBuffer.writeln(line);
    debugPrint(line); // 保留原控制台输出
  };

  // 启动应用
  runApp(const MyApp());
}

2. 捕获Flutter框架级错误 #

Flutter的框架错误不会通过普通print输出，需要通过FlutterError.onError监听：

FlutterError.onError = (FlutterErrorDetails details) {
  final errorLog = FlutterError.dumpErrorToConsole(details, forceReport: true);
  logBuffer.writeln('Flutter Framework Error:\n$errorLog');
};

3. 监听多Isolate的日志和错误 #

每个Isolate都是独立的执行环境，主Isolate无法直接获取其他Isolate的print输出，需要通过SendPort传递日志：

主Isolate侧： #

Future<void> spawnCustomIsolate() async {
  final logPort = RawReceivePort((dynamic message) {
    if (message is String) {
      logBuffer.writeln('Isolate Log: $message');
    } else if (message is List) {
      // 处理Isolate错误（error + stackTrace）
      final error = message[0];
      final stackTrace = message[1];
      logBuffer.writeln('Isolate Error: $error\nStackTrace: $stackTrace');
    }
  }).sendPort;

  await Isolate.spawn(
    _isolateEntry,
    logPort,
    onError: logPort, // 传递Isolate错误到主Isolate
  );
}

子Isolate侧： #

void _isolateEntry(SendPort logPort) {
  // 重定向子Isolate的print输出到主Isolate
  Zone.current.print = (String line) {
    logPort.send(line);
  };

  // 监听子Isolate内部错误
  Isolate.current.addErrorListener(logPort);

  // 子Isolate业务代码示例
  print('子Isolate的日志消息');
  // 模拟错误
  // throw Exception('子Isolate抛出的异常');
}

4. 捕获stdout/stderr输出 #

部分第三方库或原生插件可能直接输出到stdout/stderr，这时候需要重定向这两个流：

import 'dart:io';

class _LogIOSink extends IOSink {
  final StringBuffer buffer;
  final IOSink originalSink;

  _LogIOSink(this.buffer, this.originalSink);

  @override
  void write(Object? obj) {
    buffer.write(obj);
    originalSink.write(obj);
  }

  @override
  void writeln([Object? obj = '']) {
    buffer.writeln(obj);
    originalSink.writeln(obj);
  }

  // 其他方法直接委托给原Sink
  @override
  void add(List<int> data) => originalSink.add(data);
  @override
  Future<void> addStream(Stream<List<int>> stream) => originalSink.addStream(stream);
  @override
  Future<void> flush() => originalSink.flush();
  @override
  Future<void> close() => originalSink.close();
  @override
  Encoding get encoding => originalSink.encoding;
  @override
  set encoding(Encoding encoding) => originalSink.encoding = encoding;
}

// 在main函数中初始化
void main() {
  stdout = _LogIOSink(logBuffer, stdout);
  stderr = _LogIOSink(logBuffer, stderr);
  
  // ...其他初始化逻辑
}

最终使用 #

收集完日志后，直接通过logBuffer.toString()获取所有输出内容，就可以发送给自己用于调试了。

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