path.read_text() 是 python 3.12 中读取文本文件的首选方法,自动处理编码(默认 utf-8)、打开/关闭文件并返回 str,但需显式指定 encoding 防乱码,不支持二进制、大文件易内存溢出,且无自动路径校验。

Path.read_text() 是最直接的读取方式
Path.read_text() 在 Python 3.12 中仍是读取单个文本文件内容的首选方法,它自动处理编码(默认 UTF-8)、打开/关闭文件,并返回 str。不需要手动调用 open() 或管理文件句柄。
- 默认使用
encoding="utf-8",若文件是 GBK、ISO-8859-1 等其他编码,必须显式传入encoding参数,否则会抛出UnicodeDecodeError - 支持
errors参数(如"ignore"、"replace"),用于容错处理乱码 - 不支持二进制模式——想读字节必须用
read_bytes(),不能混用
from pathlib import Path
p = Path("README.md")
content = p.read_text(encoding="utf-8") # 推荐显式写 encoding
批量读取多个文本文件要用 glob() + read_text()
Path.glob() 和 Path.rglob() 是遍历路径的主力,但它们返回的是生成器,不会自动读内容;必须对每个匹配项单独调用 read_text()。
-
glob("<em>.txt")</em>只查当前目录;rglob(".py")递归查找所有子目录 - 注意:
glob()不检查文件是否真为文本——遇到 PDF、图片等二进制文件时,read_text()会因解码失败而中断 - 建议加
try/except UnicodeDecodeError包裹,跳过无法解码的文件
from pathlib import Path
root = Path(".")
for p in root.rglob("*.md"):
try:
print(p, "→", len(p.read_text()) , "chars")
except UnicodeDecodeError:
print(f"skip {p}: binary or wrong encoding")
read_text() 在 Python 3.12 没有新参数,但要注意 locale 影响
Python 3.12 对 Path.read_text() 本身没有新增参数或行为变更,但它底层依赖系统 locale 设置来推断默认编码(当未指定 encoding 且环境未设 PYTHONIOENCODING 时)。
- Linux/macOS 下常见默认为
UTF-8;Windows 控制台可能仍是cp936(GBK),导致不指定encoding时读中文文件失败 - 不要依赖隐式编码推断——始终显式传
encoding="utf-8",除非你明确需要 locale 行为 -
read_text()不支持newline参数(不像open()),换行符统一按 Python 规则处理(\n)
大文件别硬刚 read_text(),得按需分块或流式处理
read_text() 把整个文件加载进内存,对几百 MB 以上的文本文件极易触发 MemoryError,且无进度反馈。
- 单纯“快速读取所有内容”不等于“一次性全 load 进 str”——如果目标是搜索、统计、转换,往往更适合用
open(p).readline()或pathlib.Path.open()手动迭代 - 若必须转成一个大字符串(比如喂给正则全局匹配),先确认内存是否够:可用
p.stat().st_size预估大小,超 50MB 就该警惕 - 没有内置的“流式 read_text”,但可以组合:
Path.open(mode="r", encoding="utf-8")返回标准 file object,后续自由控制读取逻辑
真正容易被忽略的是:路径存在性与权限检查不在 read_text() 调用链里自动发生——它只在真正 open 时才报 FileNotFoundError 或 PermissionError。批量处理前,最好先用 p.is_file() 过滤,避免异常打断流程。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











