Directory 类 抽象 接口

文件系统上的目录（或文件夹）的引用。

Directory 是一个对象，包含可以执行操作的路径。目录的路径可以是 绝对路径 或相对路径。由于它是 FileSystemEntity，因此可以访问父目录。

Directory 还提供了对系统临时文件目录的静态访问，systemTemp，以及访问和更改 当前目录 的能力。

创建一个新 Directory 以访问指定路径的目录

var myDir = Directory('myDir');

Directory 的大多数实例方法都存在同步和异步两种版本，例如，create 和 createSync。除非你有使用方法同步版本的特定原因，否则建议使用异步版本以避免阻塞你的程序。

创建目录

以下代码示例使用 create 方法创建目录。通过将 recursive 参数设置为 true，可以创建命名的目录及其所有必要的父目录（如果它们不存在的话）。

import 'dart:io';

void main() async {
  // Creates dir/ and dir/subdir/.
  var directory = await Directory('dir/subdir').create(recursive: true);
  print(directory.path);
}

列出目录条目

使用 list 或 listSync 方法获取目录中包含的文件和目录。将 recursive 设置为 true 以递归列出所有子目录。将 followLinks 设置为 true 以跟踪符号链接。列表方法返回一个 Stream 的 FileSystemEntity 对象。监听流以访问每个对象

import 'dart:io';

void main() async {
  // Get the system temp directory.
  var systemTempDir = Directory.systemTemp;

  // List directory contents, recursing into sub-directories,
  // but not following symbolic links.
  await for (var entity in
      systemTempDir.list(recursive: true, followLinks: false)) {
    print(entity.path);
  }
}

异步方法的使用

I/O 操作可能会在等待操作完成的一段时间内阻塞程序。为了避免这种情况，所有涉及 I/O 的方法都有一个异步版本，它返回一个 Future。此 future 在 I/O 操作完成时完成。在 I/O 操作进行时，Dart 程序不会被阻塞，可以执行其他操作。

例如，确定目录是否存在的 exists 方法，使用 Future 异步返回一个布尔值。

import 'dart:io';

void main() async {
  final myDir = Directory('dir');
  var isThere = await myDir.exists();
  print(isThere ? 'exists' : 'nonexistent');
}

除了 exists 之外，stat、rename 和其他方法也是异步的。

其他资源

• 库导游中的 文件和目录 部分。

• 编写命令行应用程序，这是一个关于编写命令行应用程序的教程，包括关于文件和目录的信息。