Flutter Windows桌面应用如何以事件形式获取串口数据

你现在用的serial_port_win32确实没有封装上层事件回调，但Windows系统原生提供了真正的串口事件触发能力，完全不需要轮询、不需要设置读超时，实现成本很低。

核心实现原理 #

Windows内核层会监控串口状态，当你注册的串口事件触发时（比如接收缓冲区收到新字节），会主动唤醒等待该事件的线程，无数据时等待线程会被系统挂起，完全不占用CPU资源，属于真正的事件驱动模式，不存在空轮询开销。

具体实现步骤 #

• 第一步：获取串口底层句柄
  serial_port_win32打开串口后内部持有Win32串口句柄，你可以通过扩展方法、或者直接修改包源码暴露该句柄，不需要替换现有依赖、重写已有的收发逻辑。
• 第二步：注册串口监听事件
  通过FFI调用Win32原生APISetCommMask，给串口句柄绑定EV_RXCHAR事件，该事件对应「接收缓冲区有新字节到达」。
• 第三步：独立线程等待事件
  由于等待事件的API是阻塞调用，需要开一个单独的长期驻留Isolate运行等待逻辑，避免阻塞UI线程。在该Isolate中循环调用WaitCommEventAPI，无数据时线程会被系统挂起，有数据时API立刻返回。
• 第四步：触发数据读取逻辑
  WaitCommEvent检测到数据到达事件后，通过SendPort给主Isolate发信号，主Isolate收到信号后直接调用串口实例的read方法读取当前缓冲区所有可用数据，传入你自己的业务处理函数、更新对应Widget即可。

关键代码示例 #

import 'dart:ffi';
import 'dart:isolate';
import 'package:ffi/ffi.dart';
import 'package:win32/win32.dart';

// 事件掩码，对应串口接收到新字符
const EV_RXCHAR = 0x0001;

void startSerialListen(SerialPort port, void Function(Uint8List data) onData) async {
  final receivePort = ReceivePort();
  // 替换为你从SerialPort实例实际获取到的底层句柄值
  final portHandle = port.handle; 
  
  // 注册要监听的串口事件
  SetCommMask(portHandle, EV_RXCHAR);

  // 启动独立Isolate等待事件
  await Isolate.spawn<_IsolateArgs>((args) {
    final eventMask = calloc<Uint32>();
    while (true) {
      // 阻塞等待，无数据时0 CPU占用
      final result = WaitCommEvent(args.handle, eventMask, nullptr);
      if (result == 0) break; // 串口关闭时退出循环
      if (eventMask.value & EV_RXCHAR != 0) {
        args.sendPort.send(null);
      }
    }
    calloc.free(eventMask);
  }, _IsolateArgs(receivePort.sendPort, portHandle));

  // 主Isolate收到信号后读取数据、触发回调
  receivePort.listen((_) {
    final available = port.bytesAvailable;
    if (available > 0) {
      final data = port.read(available);
      onData(data);
    }
  });
}

class _IsolateArgs {
  final SendPort sendPort;
  final int handle;
  _IsolateArgs(this.sendPort, this.handle);
}

使用的时候直接调用startSerialListen(你的串口实例, (data){ 处理数据、更新Widget })即可，完全不需要定时器、不需要读超时。

其他可选方案 #

如果你不想自己写FFI逻辑，可以替换依赖为libserialport，该库基于跨平台原生libserialport实现，内置了事件驱动的数据流API，直接listen对应的流即可收到数据通知，缺点是需要打包对应版本的Windows动态库，部署成本比上面的方案稍高。

常见误区说明 #

你之前理解的「Stream需要轮询检测数据」是事件来源的问题，和Stream本身无关：如果事件来源是系统级的阻塞等待触发，基于该逻辑封装的Stream就是纯事件驱动，没有任何轮询开销。你可以很方便地把上面的回调逻辑封装成Stream对外提供，使用体验和原生事件没有区别。

注意：不要在等待事件的独立Isolate中直接操作串口实例、更新UI，Dart的Isolate内存不共享，跨Isolate操作串口句柄会导致异常，等待线程仅负责传递事件信号，实际读写、UI更新逻辑全部放在主Isolate执行即可。

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