Dart中await stdin.first语句的工作原理是什么？

先看你给出的代码：

void main(final List<String> $) async {
  print("Entering main");
  stdout.write("Press Enter key to terminate the program : ");
  await stdin.first;
  print("Exiting main");
}

你疑惑的是await stdin.first;为什么会等待用户按回车，以及它的实现逻辑，下面一步步拆解：

1. stdin的本质 #

stdin是Dart dart:io库提供的标准输入流实例，它实现了Stream<List<int>>接口——本质上是一个字节数据流，专门用来接收控制台的用户输入。

2. Stream.first的逻辑 #

所有Dart Stream都自带first这个getter，它会返回一个Future<List<int>>。这个Future的行为很明确：

• 一直处于等待状态，直到Stream发出第一个数据事件
• 当第一个事件到来时，Future完成，并把该事件的字节数据作为返回结果

3. 为什么要等回车键？ #

控制台输入默认是行缓冲模式：用户输入的字符会被系统暂时缓存，只有当按下回车键时，系统才会把整行内容（包括回车对应的字节）打包成一个数据事件，发送给stdin流。这就是stdin.first要等回车的核心原因——它在等待第一个完整的输入事件触发。

4. await的作用 #

因为main被标记为async函数，await会暂停当前main函数的执行流程，直到stdin.first返回的Future完成（也就是用户按下回车触发第一个输入事件），之后才会继续执行后面的print("Exiting main");。

这里我们不需要使用stdin.first返回的字节数据，所以只是单纯利用Future的完成时机来阻塞程序退出。

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