Flutter 文件操作

封面图 • 2025-11-14 • Flutter

在 Flutter 中进行文件操作，可以使用 `dart:io` 库中的 `File` 和 `Directory` 类。这些类提供了读取、写入、创建和删除文件的功能。

以下是一些常见的 Flutter 文件操作示例：

---

## 1. 获取应用的文档目录（推荐）

Flutter 提供了获取应用专属存储路径的方法，通常用于保存用户数据。

```dart
import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<void> getApplicationDocumentsDirectory() async {
  final directory = await getApplicationDocumentsDirectory();
  print('App Documents Directory: ${directory.path}');
}
```

---

## 2. 创建并写入文件

```dart
import 'dart:io';
import 'package:path_provider/path_provider.dart';

Future<void> writeToFile(String content) async {
  final directory = await getApplicationDocumentsDirectory();
  final file = File('${directory.path}/example.txt');

// 写入内容到文件
  await file.writeAsString(content);
  print('File written successfully.');
}
```

---

## 3. 读取文件内容

```dart
Future<String> readFromFile() async {
  final directory = await getApplicationDocumentsDirectory();
  final file = File('${directory.path}/example.txt');

if (await file.exists()) {
    String content = await file.readAsString();
    return content;
  } else {
    return 'File does not exist.';
  }
}
```

---

## 4. 检查文件是否存在

```dart
Future<bool> checkFileExists() async {
  final directory = await getApplicationDocumentsDirectory();
  final file = File('${directory.path}/example.txt');
  return await file.exists();
}
```

---

## 5. 删除文件

```dart
Future<void> deleteFile() async {
  final directory = await getApplicationDocumentsDirectory();
  final file = File('${directory.path}/example.txt');

if (await file.exists()) {
    await file.delete();
    print('File deleted successfully.');
  } else {
    print('File does not exist.');
  }
}
```

---

## 6. 读取 CSV 或 JSON 文件（示例）

### 读取 JSON 文件：

```dart
import 'dart:convert';

Future<void> readJsonFile() async {
  final directory = await getApplicationDocumentsDirectory();
  final file = File('${directory.path}/data.json');

if (await file.exists()) {
    String jsonStr = await file.readAsString();
    Map<String, dynamic> data = json.decode(jsonStr);
    print('Data: $data');
  }
}
```

---

## 注意事项：

- **权限问题**：在 Android 上，如果要访问外部存储（如 SD 卡），需要申请权限。
- **iOS 的沙盒机制**：iOS 不允许直接访问文件系统，只能通过 `path_provider` 获取的路径来操作文件。
- **避免大文件操作**：不要一次性读取太大的文件，以免导致内存溢出。

---

如果你有具体的场景（比如读取图片、音频、CSV 等），我可以提供更详细的代码示例。欢迎继续提问！