Python 文件操作：读取与写入核心指南

3. 打开模式一览

open() 的 mode 参数是一个字符串，其中常见的模式有：

注意：

• 文本模式下，写入时换行符 会被自动转换为当前系统的换行符（Windows 为 ，Linux/macOS 为 ）；读取时则自动转换回来。如果你处理的是二进制文件（如图片、视频），必须使用二进制模式 'b'，避免这种转换。
• 所有模式都可以与 '+' 组合，实现读写同时进行（如 'r+'），但对初学者不常用，可暂不展开。

4. 一个完整的示例（只读）

下面是一个完整的读取文件示例，包含了路径构建和异常处理：

from pathlib import Path

# 假设当前脚本在项目根目录，我们想读取 data/poem.txt
file_path = Path(__file__).parent / 'data' / 'poem.txt'
try:
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
        print(content)
except FileNotFoundError:
    print(f'文件不存在：{file_path}')
except UnicodeDecodeError:
    print('文件编码可能不是 UTF-8，请检查')

这个例子综合了基于 __file__ 构建路径的知识和本篇的核心步骤。

5. 小结

文件操作的核心步骤可以总结为：

• 用 open() 打开文件，指定路径、模式和编码。
• 用 with 语句包裹操作，确保文件自动关闭。
• 在 with 块内进行读取或写入。

掌握了这个框架，接下来我们就可以深入探讨具体的读取方法和写入方法了。

读取文件：把数据从磁盘'请'到内存

掌握了文件操作的核心步骤后，我们来看最常用的操作——读取文件。读取文件就是将磁盘上存储的数据加载到内存中，供程序处理。Python 提供了多种读取方法，适用于不同场景。

1. 准备工作：打开文件用于读取

要读取文件，首先要用 open() 函数以只读模式打开它。模式参数为 'r'（默认，可以省略）。同时，强烈建议指定文件编码，特别是当文件包含中文等非英文字符时。

# 基本写法
f = open('poem.txt', 'r', encoding='utf-8')
content = f.read()
f.close()

但正如前面所说，更安全的做法是使用 with 语句，它会自动关闭文件：

with open('poem.txt', 'r', encoding='utf-8') as f:
    content = f.read()
    # 在缩进块内使用 content
# 离开缩进后文件自动关闭

接下来的所有示例都将采用 with 语句。

2. 三种常用的读取方法

1. read()：一次性读取整个文件

read() 方法会将文件的全部内容作为一个字符串返回。它适合读取较小的文件，因为如果文件太大（比如几个 GB），一次性读入内存可能会导致内存溢出。

with open('poem.txt', 'r', encoding='utf-8') as f:
    content = f.read()
    print(content)

假设 poem.txt 内容为：

我们之间的回忆 全部都小心地收集 我总是偷偷地哭泣 像倦鸟失了归期 但愿我相信的爱情 结局紧握在我手心 时光匆匆却没有遗失过去 

输出结果就是文件的全部内容。

read() 也可以指定读取的字符数（或字节数，在二进制模式下），例如 f.read(100) 只读取前 100 个字符。

2. readline()：逐行读取

readline() 每次读取一行，包括行尾的换行符（ ）。当文件较大时，逐行读取可以节省内存，因为每次只处理一行。

with open('poem.txt', 'r', encoding='utf-8') as f:
    line = f.readline()
    while line:
        print(line, end='')
        # 因为 line 已经包含换行符，print 默认也会换行，所以用 end='' 去掉多余的换行
        line = f.readline()

输出结果与文件内容一致。

更优雅的方式是直接迭代文件对象，这本质上是调用 readline() 的简化写法（见下一节：3. 逐行读取的最佳实践）。

3. readlines()：读取所有行到列表

readlines() 将文件的所有行读取到一个列表中，每一行（包括换行符）作为列表的一个元素（所以一般会和 for 循环相结合）。它也适合小文件，因为会将整个文件加载到内存。

with open('poem.txt', 'r', encoding='utf-8') as f:
    lines = f.readlines()
    for line in lines:
        print(line, end='')

输出结果同样与文件内容一致。

注意：readlines() 返回的列表中的每一行都保留了换行符，如果你不需要换行符，可以用 strip() 去除。

3. 逐行读取的最佳实践

Python 的文件对象本身是可迭代的，这意味着你可以直接用 for line in f 来逐行读取文件。这种方式既简洁又内存友好，是处理大文件的推荐做法。

with open('poem.txt', 'r', encoding='utf-8') as f:
    for line in f:
        print(line, end='')

这比使用 while 循环调用 readline() 更简洁，也比 readlines() 更节省内存（因为不会一次加载所有行）。

4. 处理文件不存在的情况

如果尝试读取的文件不存在，Python 会抛出 FileNotFoundError。为了让程序更健壮，可以使用 try...except 捕获这个异常。

from pathlib import Path

file_path = Path('data') / 'poem.txt'
try:
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
        print(content)
except FileNotFoundError:
    print(f'错误：文件 {file_path} 不存在，请检查路径。')

这样程序就不会直接崩溃，而是给出友好的提示。

5. 处理编码问题

当文件的编码与 open() 中指定的 encoding 不一致时，可能会抛出 UnicodeDecodeError 或出现乱码。例如，一个用 GBK 编码的文件如果用 utf-8 读取就会出错。

解决方案：

• 确定文件的实际编码，并用正确的编码打开。
• 如果不确定，可以使用 chardet 库自动检测编码（但初学者可以先假设文件是 UTF-8 编码）。
• 始终在 open() 中明确指定 encoding 参数，避免依赖系统默认编码（不同操作系统默认编码可能不同）。

try:
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
except UnicodeDecodeError:
    print('无法以 UTF-8 编码读取文件，请尝试其他编码如 gbk。')

6. 小贴士：读取文件后的数据处理

读取文件后，通常需要对内容进行处理。例如，统计文件行数、单词数，或者按行解析数据。

示例：统计文件行数

with open('poem.txt', 'r', encoding='utf-8') as f:
    line_count = 0
    for line in f:
        line_count += 1
    print(f'文件共有 {line_count} 行')

示例：读取所有行并去除换行符

with open('poem.txt', 'r', encoding='utf-8') as f:
    lines = [line.rstrip('\n') for line in f]
    # 使用列表推导式去除换行符
    print(lines)

7. 小结

读取文件的要点可以归纳为：

• 使用 with open(...) as f 确保文件正确关闭。
• 根据文件大小和需求选择合适的读取方法：
  • 小文件：read() 或 readlines()
  • 大文件或逐行处理：迭代文件对象（for line in f）
• 始终指定 encoding='utf-8' 避免编码问题。
• 用 try...except 处理文件不存在等异常情况。

掌握了这些，你已经能够轻松读取各种文本文件了。下一节我们将学习如何将数据写入文件，让程序能够持久化保存结果。

写入文件：把数据从内存'保存'到磁盘

学会了读取文件，接下来我们看看如何将数据写入文件。写入文件是程序持久化存储数据的基本方式，比如保存用户配置、记录日志、输出处理结果等。与读取类似，写入也遵循'打开 → 操作 → 关闭'的核心步骤，但使用的打开模式不同。

1. 打开模式：写入、追加与独占

写入文件时，需要根据需求选择合适的打开模式：

对于初学者，最常用的是 'w' 和 'a'：

• 'w'：适合需要全新写入的场景，比如程序每次运行生成新的输出文件。
• 'a'：适合需要保留历史记录的日志文件，或者希望追加内容而不覆盖原文件。

⚠️ 特别注意：'w' 模式会清空文件原有内容！如果文件里有重要数据，使用前务必确认或做好备份。

2. 写入方法：write() 与 writelines()

写入文件主要通过两个方法：

• write(data)：将字符串 data 写入文件。返回写入的字符数（或字节数）。不会自动添加换行符，如果需要换行，必须手动写入 。
• writelines(lines)：将一个字符串列表写入文件。它也不会自动添加换行符，如果列表中的字符串不包含换行符，所有内容会连在一起。

示例：使用 write() 写入

with open('output.txt', 'w', encoding='utf-8') as f:
    f.write('第一行内容')
    f.write('第二行内容')
    # 这会在第一行后面直接接着写，没有换行

结果 output.txt 中只有一行：第一行内容第二行内容。

要分行，必须显式加入 ：

with open('output.txt', 'w', encoding='utf-8') as f:
    f.write('第一行内容\n')
    f.write('第二行内容\n')

示例：使用 writelines() 写入

lines = ['第一行\n', '第二行\n', '第三行\n']
with open('output.txt', 'w', encoding='utf-8') as f:
    f.writelines(lines)

注意 lines 中的每个字符串已经包含了换行符 ，如果忘记加，它们会挤在一行。

3. 示例代码：覆盖写入与追加写入

覆盖写入 ('w')

from pathlib import Path

# 构建路径（沿用上一篇的技巧）
file_path = Path(__file__).parent / 'output' / 'notes.txt'

# 确保父目录存在
file_path.parent.mkdir(parents=True, exist_ok=True)

# 写入内容（覆盖）
with open(file_path, 'w', encoding='utf-8') as f:
    f.write('这是第一行。\n')
    f.write('这是第二行。\n')
print(f'已写入文件：{file_path}')

每次运行这段代码，notes.txt 都会只包含最新写入的两行。

追加写入 ('a')

with open(file_path, 'a', encoding='utf-8') as f:
    f.write('这是追加的一行。\n')

多次运行，文件末尾会不断添加新行，原内容保留。

独占创建写入 ('x')

try:
    with open('new_file.txt', 'x', encoding='utf-8') as f:
        f.write('这个文件是全新创建的。')
except FileExistsError:
    print('文件已存在，无法创建。')

'x' 模式确保不会意外覆盖现有文件，适合需要原子性创建的场合。

4. 写入前的准备工作：确保目录存在

写入文件时，如果文件路径中包含尚不存在的目录，Python 会抛出 FileNotFoundError。因此，在写入前应确保所有父目录都已存在。使用 pathlib 可以轻松完成：

from pathlib import Path

output_path = Path('data') / 'results' / 'output.txt'

# 创建所有父目录（如果不存在）
output_path.parent.mkdir(parents=True, exist_ok=True)

# 现在可以安全写入
output_path.write_text('Hello, world!', encoding='utf-8')

mkdir(parents=True, exist_ok=True) 会递归创建缺失的目录，并且如果目录已存在也不会报错。

5. 使用 pathlib 简化写入

如果你已经在使用 pathlib，可以直接调用 Path.write_text() 方法，一行搞定写入：

from pathlib import Path

file_path = Path('hello.txt')
file_path.write_text('你好，世界！', encoding='utf-8')

这个方法内部会处理文件的打开和关闭，如果文件已存在，默认会覆盖（等同于 'w' 模式）。它同样需要父目录存在，所以创建文件前最好调用 file_path.parent.mkdir(...)。

6. 注意事项与常见错误

• 忘记换行符：写入多行时，如果不手动添加 ，所有内容会挤在一起。
• 覆盖风险：使用 'w' 模式前，确认是否真的想清空文件。可以先用 Path.exists() 检查文件是否存在，询问用户确认。
• 目录不存在：务必先创建父目录，否则报错。
• 编码问题：始终指定 encoding='utf-8'，避免其他程序读取时出现乱码。
• 未关闭文件：使用 with 语句可以自动关闭，但如果你不用 with，一定要在写入后调用 f.close()，否则数据可能没有真正写入磁盘（由于缓冲）。

示例：安全写入前检查

file_path = Path('important.txt')
if file_path.exists() and input('文件已存在，覆盖？(y/n)') != 'y':
    print('取消写入')
else:
    file_path.write_text('新内容', encoding='utf-8')

7. 小结

写入文件的要点：

• 选择合适的模式：'w'（覆盖）、'a'（追加）、'x'（独占）。
• 使用 with 语句确保文件正确关闭。
• 手动添加换行符 以实现分行。
• 写入前确保父目录存在（mkdir(parents=True)）。
• 始终指定 encoding='utf-8'。
• 可以用 pathlib 的 write_text() 简化操作。