dart:io 库

为非 Web 应用程序提供文件、套接字、HTTP 等输入/输出支持。

重要：基于浏览器的应用程序无法使用此库。只有以下内容可以导入和使用 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 服务器，请参阅 在 dart.dev 上编写 HTTP 服务器。

进程

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的WebSocket.connect方法和使用WebSocket协议的URI来连接WebSocket。客户端可以使用WebSocket的WebSocket.add方法写入数据。例如，

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

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

套接字和服务器套接字

客户端和服务器使用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类可用于对异步套接字IO进行低级访问。

标准输出、错误和输入流

此库提供了标准输出、错误和输入流，分别命名为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();