dart:io 库

非 Web 应用程序的文件、套接字、HTTP以及其他 I/O 支持。

重要：基于浏览器的应用程序无法使用此库。以下内容可以导入和使用 dart:io 库：

• 服务器
• 命令行脚本
• Flutter 移动应用
• Flutter 桌面应用

此库允许您处理文件、目录、套接字、进程、HTTP 服务器和客户端等。许多与输入和输出相关的操作都是异步的，并使用 Future 或 Stream 来处理，这两个类均在 dart:async 库 中定义。

要在代码中使用 dart:io 库

import 'dart:io';

有关 Dart 中 I/O 的介绍，请参阅 dart:io 库之旅。

文件、目录和链接

File、Directory 或 Link 的实例分别表示在本地文件系统中对应的文件、目录或链接。

您可以通过这些类型的对象操作文件系统。例如，您可以重命名文件或目录。

File myFile = File('myFile.txt');
myFile.rename('yourFile.txt').then((_) => print('file renamed'));

File、Directory 和 Link 类提供的许多方法都是异步的，并返回一个 Future。

FileSystemEntity

File、Directory 和 Link 都扩展了 FileSystemEntity。除了是这些类的超类外，FileSystemEntity 还具有许多用于处理路径的静态方法。

要获取有关路径的信息，您可以使用如：FileSystemEntity 的静态方法，例如 FileSystemEntity.isDirectory、FileSystemEntity.isFile 和 FileSystemEntity.exists。由于文件系统访问涉及 I/O，因此这些方法是异步的，并返回一个 Future。

FileSystemEntity.isDirectory(myPath).then((isDir) {
  if (isDir) {
    print('$myPath is a directory');
  } else {
    print('$myPath is not a directory');
  }
});

HttpServer 和 HttpClient

HttpClient 和 HttpServer 类提供了底层的 HTTP 功能。

考虑使用软件包中发现的更易于使用和组合的 API，而不是直接使用这些类。

对于 HTTP 客户端，请参阅 package:http。

对于 HTTP 服务器，请参阅 Write HTTP servers on dart.dev。

Process

Process 类提供了一种在本地机器上运行进程的方式。例如，以下代码启动了一个递归列出 web 下的文件的进程。

Process.start('ls', ['-R', 'web']).then((process) {
  stdout.addStream(process.stdout);
  stderr.addStream(process.stderr);
  process.exitCode.then(print);
});

Process.start 返回一个 Future，当进程启动时，它将完成并返回一个 Process 对象。此 Process 对象允许您在进程运行时与之交互。使用 Process.run 返回一个 Future，当生成的进程已终止时，它会完成并返回一个 ProcessResult 对象。此 ProcessResult 对象收集了进程的输出和退出码。

在使用 Process.start 时，您需要读取来自 Process.stdout 和 Process.stderr 流的所有数据，否则系统资源将不会被释放。

WebSocket

WebSocket 类提供了对 WebSocket 协议的支持。这允许客户端和服务器应用程序之间进行全双工通信。

WebSocket服务器使用正常的HTTP服务器来接受WebSocket连接。初始化握手是一个HTTP请求，然后升级成WebSocket连接。服务器使用WebSocketTransformer升级请求，并监听返回的WebSocket上的数据。例如，这里有一个迷你服务器，它监听WebSocket上的'ws'数据。

runZoned(() async {
  var server = await HttpServer.bind('127.0.0.1', 4040);
  server.listen((HttpRequest req) async {
    if (req.uri.path == '/ws') {
      var socket = await WebSocketTransformer.upgrade(req);
      socket.listen(handleMsg);
    }
  });
}, onError: (e) => print("An error occurred."));

客户端使用WebSocket.connect方法和一个使用WebSocket协议的URI通过连接到WebSocket。客户端可以使用WebSocket.add方法将数据写入WebSocket。例如，

var socket = await WebSocket.connect('ws://127.0.0.1:4040/ws');
socket.add('Hello, World!');

查看websocket_sample应用程序，它使用WebSocket与服务器通信。

Socket和ServerSocket

客户端和服务端使用Socket通信TCP协议。服务端使用ServerSocket，客户端使用Socket。服务器创建一个使用bind()方法的监听套接字，然后在该套接字上监听传入的连接。例如

ServerSocket.bind('127.0.0.1', 4041)
  .then((serverSocket) {
    serverSocket.listen((socket) {
      socket.transform(utf8.decoder).listen(print);
    });
  });

客户端可以通过connect()方法连接一个Socket，它返回一个Future。使用write()、writeln()或writeAll()是最简单的发送数据到套接字的方式。例如

Socket.connect('127.0.0.1', 4041).then((socket) {
  socket.write('Hello, World!');
});

除了Socket和ServerSocket之外，还有RawSocket和RawServerSocket类可以用于更底层的异步套接字I/O访问。

标准输出、错误和输入流

该库提供了标准输出、错误和输入流，分别命名stdout、stderr和stdin。

stdout和stderr流都是IOSink，具有相同的方法和属性集。

要将字符串写入stdout

stdout.writeln('Hello, World!');

要将对象列表写入stderr

stderr.writeAll([ 'That ', 'is ', 'an ', 'error.', '\n']);

标准输入流是真实的Stream，因此它继承了Stream类的属性和方法。

从命令行同步读取文本（程序阻止等待用户输入信息）

String? inputText = stdin.readLineSync();