跨平台开发 / 系统课时

读写应用目录中的文件

读写应用目录中的文件

本篇将解决 Flutter 应用如何保存少量本地文件的问题。你会学习获取系统提供的可写目录,并通过文件 API 完成文本和 JSON 数据的写入与读取,为配置缓存、离线数据等场景建立基础。

学习目标

  • 理解 Flutter 应用沙盒目录与可写文件位置的关系
  • 掌握使用 path_provider 获取应用目录的方法
  • 完成文本文件和 JSON 文件的保存与读取

认识应用可写目录

移动应用通常不能随意访问设备文件系统,而是在自己的沙盒空间中读写数据。Flutter 应用需要通过平台提供的目录接口获取安全路径,再使用 Dart 文件 API 操作文件。

常见目录用途如下:

目录类型 用途 是否适合保存用户数据
Documents 长期保存的应用文件 适合
Temporary 临时缓存文件 不保证长期存在
Application Support 应用内部配置数据 适合

如果数据需要随着应用运行持续存在,例如草稿、导入文件或本地缓存,可以选择持久化目录;如果只是临时计算结果,则可以使用临时目录。

使用 path_provider 获取目录

Flutter 默认没有直接提供跨平台文件路径,需要使用 path_provider 插件。

先添加依赖:

yaml
dependencies:
  path_provider: ^2.1.4

下面示例将 JSON 数据写入应用文档目录,并再次读取。

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

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

  // 使用 JSON 保存结构化数据,便于后续扩展字段。
  final data = {
    'theme': 'dark',
    'fontSize': 16,
  };

  await file.writeAsString(jsonEncode(data));

  final content = await file.readAsString();
  final settings = jsonDecode(content);

  print(settings['theme']);
}

预期结果

text
dark

实际目录路径会根据 Android、iOS 或桌面平台环境变化,不应把绝对路径写死在代码中。

文件读写中的常见处理

文件操作属于异步 IO,通常需要使用 async 和 await 等待完成。如果直接读取不存在的文件,需要先判断文件状态,避免抛出异常。

dart
import 'dart:io';

Future<String?> readConfig(File file) async {
  if (!await file.exists()) {
    return null;
  }

  return file.readAsString();
}

预期结果

text
文件存在时返回文本内容,不存在时返回 null

对于复杂业务,例如用户账号、订单数据或大量列表数据,直接管理文件会变得困难,此时应考虑数据库或专用缓存方案。

什么时候使用文件存储

文件存储适合结构简单、访问频率较低的数据,例如:

  • 应用设置
  • 小型 JSON 配置
  • 用户导出的文件
  • 离线缓存快照

如果需要查询、排序、条件过滤大量数据,应使用 SQLite 等数据库方案,而不是把所有内容保存到单个文件中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读写应用目录中的文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通