读取与写入文件
加载并保存文本与字节
读取与写入文件 是 CoddyKit 上的免费 Dart Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Dart Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Dart Academy 课程共包含 4 节课。
为什么使用 dart:io
要在命令行程序中操作真实文件，需要导入 dart:io。它让 Dart 能够读取和写入磁盘。
import 'dart:io';认识文件类
文件对象指向磁盘上的一个路径。创建它并不会立即打开或读取任何内容，只是为目标命名。
final file = File('notes.txt');读取整个文件
使用 readAsString 可以将整个文本文件读入一个字符串。它会返回一个异步结果，因此需要等待该结果。
final text = await file.readAsString();逐行读取
想要得到行列表吗？readAsLines 会将每一行作为独立的字符串交给您，非常适合逐行处理。
final lines = await file.readAsLines();写出文本
要保存文本，请调用 writeAsString。如果文件不存在，它会创建文件；默认情况下，它会替换已有内容。
await file.writeAsString('Hello, disk!');追加而不是替换
想保留旧文本并添加更多内容吗？传入 FileMode.append，新内容就会写到末尾。
await file.writeAsString('line\n', mode: FileMode.append);处理字节数据
文件不一定是文本。使用 readAsBytes 可以将原始数据作为整数列表获取，用于图像或二进制格式。
final bytes = await file.readAsBytes();先检查是否存在
读取不存在的文件会抛出错误。在完全接触文件之前，先使用 exists 检查，可以避免这个问题。
if (await file.exists()) { /* safe to read */ }同步版本
每个异步方法都有一个类似 readAsStringSync 的阻塞版本。它适合小型脚本，但运行期间会冻结所有操作。
final text = file.readAsStringSync();删除和重命名
使用 delete 进行清理，或者使用新路径调用 rename 来移动文件。两者都会返回可以等待的异步结果。
await file.rename('archive.txt');选择正确的编码
文本方法默认使用 utf8。对于其他编码，请传入明确的编码方式，以确保带重音符号或特殊字符的内容在读写往返后仍然正确。
await file.writeAsString(s, encoding: latin1);快速检查
您想添加一行 log，而不删除已有内容。哪个选项可以做到这一点？
回顾
现在您可以将文件读取为字符串、行或 bytes，也可以写入或追加文本，并使用 exists 进行保护检查。这就是文件输入输出的核心。
常见问题解答
「读取与写入文件」课时是免费的吗？
是的 — 「读取与写入文件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Dart Academy 课程的其余内容，请升级到 CoddyKit PRO。 Dart Academy 课程共包含 4 节课。
「读取与写入文件」这节课中我会学到什么？
加载并保存文本与字节 你通过在浏览器中直接运行的动手代码来练习 Dart Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Dart Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Dart Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「读取与写入文件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Dart Academy 课中编写并运行代码吗？
能。每节 Dart Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。