Flutter Mobile Development · 课时

文件系统操作

学习从设备文件系统读取数据和向其中写入数据，以支持存储较大的文件和自定义数据格式。

第 3 / 4 课12 个步骤

文件系统操作 是 CoddyKit 上的免费 Flutter Mobile Development 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Flutter Mobile Development 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Flutter Mobile Development 课程共包含 4 节课。

本课时的部分内容尚未翻译，以英文显示。

Storing Data in Files

Sometimes, your app needs to store data directly on the device. This is where file system operations come in! Unlike shared_preferences (for small key-value data) or sqflite (for structured data), file system operations allow you to manage files directly.

You can store larger pieces of data, like images, audio, or custom formatted text files, that don't fit well into a database or simple key-value pairs.

Where to Store Files?

Before you can read or write files, your app needs to know where it can store them. Flutter provides the path_provider package to help you find common directory paths safely across different platforms (iOS, Android, web, desktop).

Application Documents Directory: This is where your app can store user-specific data that should persist.
Temporary Directory: For data that doesn't need to persist across app launches, like cached files.

Getting Application Path

Let's use path_provider to get the application documents directory. Remember to add path_provider to your pubspec.yaml first!

dependencies: flutter: sdk: flutter path_provider: ^2.0.11

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

void main() async {
  // Get the application documents directory
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;

  print('App Documents Path: $appDocPath');
}

Creating a File Reference

Once you have a directory path, you can create a File object. This object represents the file at that specific path on the device's storage. It doesn't mean the file actually exists yet, it's just a reference.

You'll combine the directory path with your desired filename to construct the full file path.

Constructing a File Path

Here's how you can combine the application documents path with a filename to create a File object. We'll use a simple text file name for our example.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;

  // Define a filename
  String fileName = 'my_data.txt';

  // Create a File object
  File file = File('$appDocPath/$fileName');

  print('File path reference created: ${file.path}');
  // At this point, the file might not exist on disk yet.
}

Saving Content to Files

The File object provides methods to write data. The most common ones are writeAsString() for text and writeAsBytes() for binary data. These operations are asynchronous, so you'll use await.

writeAsString(String contents, {FileMode mode = FileMode.write}): Writes text. FileMode.write overwrites, FileMode.append adds to the end.
writeAsBytes(List<int> bytes, {FileMode mode = FileMode.write}): Writes raw bytes.

Writing a Simple Text File

Let's write some text content to our my_data.txt file. If the file doesn't exist, writeAsString will create it. If it does exist, it will overwrite its content by default.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;
  String fileName = 'my_data.txt';
  File file = File('$appDocPath/$fileName');

  String content = 'Hello, CoddyKit learners!\nThis is a test message.';

  try {
    await file.writeAsString(content);
    print('Content written to ${file.path}');
    print('File exists: ${await file.exists()}');
  } catch (e) {
    print('Error writing file: $e');
  }
}

Reading Content from Files

Just as you can write, you can also read content back from files. The readAsString() method is perfect for text files, while readAsBytes() is used for binary data.

It's good practice to check if a file exists() before trying to read from it to prevent errors.

Reading a File's Content

Now, let's read the content we just wrote back from my_data.txt. We'll first check if the file exists to be safe.

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

void main() async {
  Directory appDocDir = await getApplicationDocumentsDirectory();
  String appDocPath = appDocDir.path;
  String fileName = 'my_data.txt';
  File file = File('$appDocPath/$fileName');

  if (await file.exists()) {
    try {
      String content = await file.readAsString();
      print('Content read from ${file.path}:\n$content');
    } catch (e) {
      print('Error reading file: $e');
    }
  } else {
    print('File does not exist: ${file.path}');
  }
}

Removing Files

When data is no longer needed, you can delete files from the device's storage. The delete() method on a File object will remove it. This operation is also asynchronous.

Be careful when deleting files, as this action is usually irreversible!

Check Your Understanding

Which of the following statements about Flutter file system operations are TRUE?

在交互式课程中回答

Lesson Summary

Great job! In this lesson, you've learned how to interact with the device's file system in Flutter:

Used path_provider to find appropriate storage directories.
Created File objects to reference specific files.
Wrote content to files using writeAsString().
Read content from files using readAsString().
Understood how to delete files with delete().

File system operations are crucial for storing large, custom-formatted, or sensitive data directly on the device. Next, you can explore more advanced data handling or move on to other Flutter topics!

免费开始

用 AI 导师学习 Dart — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 22
课程: 88

免费开始学习查看完整课程

常见问题解答

「文件系统操作」课时是免费的吗？

是的 — 「文件系统操作」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Flutter Mobile Development 课程的其余内容，请升级到 CoddyKit PRO。 Flutter Mobile Development 课程共包含 4 节课。

「文件系统操作」这节课中我会学到什么？

学习从设备文件系统读取数据和向其中写入数据，以支持存储较大的文件和自定义数据格式。你通过在浏览器中直接运行的动手代码来练习 Flutter Mobile Development，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Flutter Mobile Development 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Flutter Mobile Development 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「文件系统操作」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Flutter Mobile Development 课中编写并运行代码吗？

能。每节 Flutter Mobile Development 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Flutter Mobile Development