pathlib read_text与read_bytes详解 - Python文件读取教程

一、方法概述

Path.read_text() 和 Path.read_bytes() 是 Python pathlib 模块提供的两个便捷文件读取方法。它们将传统的三步操作简化为一个方法调用，使代码更加简洁优雅。

• read_text()：以文本模式读取文件内容，返回字符串（str）

• read_bytes()：以二进制模式读取文件内容，返回字节串（bytes）

在传统方式中，读取文件需要 open() + read() + close() 三个步骤，而使用 pathlib 只需一个方法调用即可完成。

二、语法与参数

read_text() 语法

Path.read_text(encoding=None, errors=None)

read_bytes() 语法

Path.read_bytes()

参数详解

返回值

• read_text()：返回 str，文件的全部文本内容

• read_bytes()：返回 bytes，文件的全部二进制内容

三、读取文本文件

这是最常见的使用场景。使用 read_text() 可以一行代码完成文件读取，无需手动管理文件打开和关闭。

from pathlib import Path

# 先创建测试文件
test_file = Path('test_read.txt')
test_file.write_text('Hello, Python!\n你好，世界！', encoding='utf-8')

# 读取文本内容
content = test_file.read_text(encoding='utf-8')
print(f"内容: {content}")
print(f"类型: {type(content)}")

# 清理
test_file.unlink()

# 输出：
# 内容: Hello, Python!
# 你好，世界！
# 类型: <class 'str'>

四、读取二进制文件

当需要处理图片、音频、可执行文件等二进制文件时，使用 read_bytes() 方法。它返回的是原始字节数据，可以进行任意二进制操作。

from pathlib import Path

# 创建二进制测试文件
bin_file = Path('test_read.bin')
bin_file.write_bytes(b'\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR')

# 读取二进制内容
data = bin_file.read_bytes()
print(f"字节数: {len(data)}")
print(f"前4字节: {data[:4]}")
print(f"类型: {type(data)}")

# 清理
bin_file.unlink()

# 输出：
# 字节数: 16
# 前4字节: b'\x89PNG'
# 类型: <class 'bytes'>

在实际应用中，读取文件的前几个字节常用于判断文件类型。例如，PNG 文件的前 4 个字节是 \x89PNG，PDF 文件以 %PDF 开头。

五、读取配置文件实战

下面演示一个更实际的场景：读取并解析一个简单的配置文件。这个例子展示了如何将读取到的文本内容进行进一步处理。

from pathlib import Path

# 创建配置文件
config_file = Path('app.conf')
config_file.write_text('[database]\nhost=localhost\nport=5432\nname=mydb', encoding='utf-8')

# 读取并解析配置
config_text = config_file.read_text(encoding='utf-8')
config = {}
for line in config_text.strip().split('\n'):
    if '=' in line:
        key, value = line.split('=', 1)
        config[key.strip()] = value.strip()

print(f"配置: {config}")

# 清理
config_file.unlink()

# 输出：
# 配置: {'host': 'localhost', 'port': '5432', 'name': 'mydb'}

在实际项目中，建议使用 json.loads() 解析 JSON 配置，或使用 configparser 模块处理 INI 格式配置。

六、实际应用场景

• 配置文件读取：读取 JSON、YAML、INI 等配置文件，配合相应的解析库使用

• 日志文件查看：快速读取日志文件内容进行调试或分析

• 二进制文件处理：读取图片、音频、可执行文件等二进制数据

• 数据文件加载：读取 CSV、文本数据文件进行数据处理

七、注意事项与最佳实践

注意1：read_text() 和 read_bytes() 会一次性读取整个文件到内存。对于大文件（如几百 MB 的日志文件），应使用 open() 逐行或分块读取，避免内存溢出。

注意2：read_text() 默认使用系统编码，建议始终显式指定 encoding='utf-8' 以确保跨平台一致性。

注意3：文件不存在时会抛出 FileNotFoundError，建议先用 exists() 检查或用 try-except 捕获异常。

提示：对于需要逐行处理的大文件，使用 Path.open() 配合 for line in f: 更高效，可以大幅降低内存占用。

八、方法对比表格

九、常见问题 FAQ

十、练习题