如何在终端控制台中使用Dart读取输入？其工作原理是什么？

一、常用读取方法 #

1. 同步读取单行输入 #

这是最常用的交互场景方案，程序会等待用户输入完成后再继续执行：

import 'dart:io';

void main() {
  print('请输入你的名字：');
  String? inputName = stdin.readLineSync();
  // 处理空输入情况
  print(inputName != null ? '你好，$inputName！' : '你没有输入任何内容');
}

• 特点：readLineSync()会阻塞程序，直到用户按下回车；返回String?类型，需处理用户直接回车或输入为空的空值场景。

2. 异步读取多行输入 #

适合需要连续输入多行内容的场景，基于Stream实现，不会阻塞主线程：

import 'dart:io';

void main() async {
  print('输入多行内容，输入"exit"结束：');
  // 异步迭代输入流的每一行
  await for (final line in stdin.readLines()) {
    if (line.trim() == 'exit') break;
    print('你输入的内容：$line');
  }
  print('输入结束');
}

• 特点：通过await for监听输入流事件，每输入一行就触发一次处理；适合同时需要执行其他任务的场景。

3. 无回显读取（如密码输入） #

需要隐藏用户输入内容时，可通过控制终端回显模式实现：

import 'dart:io';
import 'dart:convert';

void main() {
  print('请输入密码：');
  // 关闭终端回显，输入内容不会显示在屏幕上
  stdin.echoMode = false;
  List<int> inputBytes = [];
  int byte;
  // 读取字节直到用户按下回车（ASCII码10）
  while ((byte = stdin.readByteSync()) != 10) {
    inputBytes.add(byte);
  }
  // 恢复终端回显
  stdin.echoMode = true;
  String password = utf8.decode(inputBytes);
  print('\n密码长度：${password.length}位');
}

• 特点：直接读取原始字节，通过echoMode控制是否显示输入内容，适合敏感信息输入。

二、工作原理 #

Dart通过dart:io库提供的stdin对象（Stdin类实例）实现终端输入读取，本质是对接操作系统的标准输入流：

• 同步读取（如readLineSync()）：程序暂停执行，操作系统捕获用户输入并缓存为文本行，直到用户按下回车，再将缓存内容返回给Dart程序，程序恢复执行。
• 异步读取（如readLines()）：将输入流包装为Stream，用户每输入一行就向流中添加一个事件，Dart程序通过异步监听的方式处理这些事件，不会阻塞主线程。
• 字节级读取：直接从输入流中读取原始字节数据，再通过编码（如UTF-8）转换为字符串，支持更精细的输入控制。

三、操作流程示意图 #

用户终端操作          操作系统缓存          Dart程序处理
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ 输入文本并回车 │ → │ 缓存输入内容 │ → │ 读取stdin流 │
└─────────────┘     └─────────────┘     └─────────────┘
                                          │
                                          ▼
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│ 终端显示输出 │ ← │ 处理输入数据 │ ← │ 返回输入内容 │
└─────────────┘     └─────────────┘     └─────────────┘

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