从文本文件读取和写入字符串：底层工作原理

如何在 Swift 中读写文本文件中的字符串：深入底层

每位开发者，无论使用哪种语言，迟早都会遇到这样一个任务：从文本文件读取和写入字符串。看起来很简单，对吧？但在 Swift 中，由于其严格的类型系统和安全性，这个过程变成了一次进入文件描述符、编码和文件管理器世界的迷人旅程。如果你曾经问过自己：“当我调用 write(to:) 或 String(contentsOf:) 时，实际发生了什么？”——这篇文章就是为你准备的。

我们不仅会展示现成的解决方案，还会分解每一步：从在沙盒中查找文件到将字节写入磁盘。系好安全带，精彩即将开始！

为什么 Swift 不允许直接写 File.write(text)？

与 Python 或 JavaScript 不同，在这些语言中可以用一行代码打开并写入文件，而 Swift 要求明确指定：字符串使用什么编码？保存到哪里（Documents、Caches、Temp）？如果文件不存在怎么办？这不是缺陷，而是特性：这种方法可以防止数据泄漏，并确保你控制着每一个阶段。

整个过程基于三个关键组件：

\n
• FileManager —— “调度员”，它知道应用程序所有文件夹的位置。
\n
• Data —— 原始字节。文件系统正是与它们打交道。
\n
• String —— 我们的高级表示形式，必须转换为 Data 并再转换回来。
\n

当你编写 从文本文件读取和写入字符串 时，底层发生了一系列操作：String → Data（编码）→ 将字节写入磁盘（通过 FileHandle 或 Data 方法）。

实际示例：将字符串写入文件

让我们从最简单且最实用的场景开始。假设你正在编写一个日记应用，并希望保存笔记文本。

import Foundation\n\nlet textToSave = "你好，世界！今天是学习 Swift 的好日子。"\nlet fileName = "my_note.txt"\n\n// 1. 获取 Documents 目录路径\nguard let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {\n    fatalError("无法获取 Documents 目录")\n}\n\n// 2. 创建文件的完整路径\nlet fileURL = documentsDirectory.appendingPathComponent(fileName)\n\n// 3. 将字符串转换为 Data（使用 UTF-8 编码）\nguard let data = textToSave.data(using: .utf8) else {\n    fatalError("字符串编码错误")\n}\n\n// 4. 将数据写入磁盘\ndo {\n    try data.write(to: fileURL, options: .atomic)\n    print("文件已成功保存到路径：\\(fileURL.path)")\n} catch {\n    print("写入错误：\\(error.localizedDescription)")\n}

底层发生了什么？

\n
• FileManager.default.urls(for:in:) —— 返回目录的 URL。在 iOS 中，这是一个隔离的沙盒。
\n
• data(using: .utf8) —— 字符串中的每个字符（甚至包括表情符号）都按照 UTF-8 标准编码为一个或多个字节。
\n
• data.write(to:options:) —— 系统调用，如果指定了 .atomic，它会原子性地将数据写入临时文件，然后重命名为目标文件。这可以防止在发生故障时数据损坏。
\n

从文件读取字符串：反向过程

现在，我们已经保存了笔记，让我们把它读回来。这是 从文本文件读取和写入字符串 的经典示例。

import Foundation\n\nlet fileName = "my_note.txt"\n\nguard let documentsDirectory = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {\n    fatalError("无法获取 Documents 目录")\n}\n\nlet fileURL = documentsDirectory.appendingPathComponent(fileName)\n\ndo {\n    // 1. 读取原始