Python 教程 / 用 with 和字符编码读写文本文件
读写文本文件时,应按文件的实际字符编码打开,并使用 with 在代码块退出时关闭文件。w模式会截断已有文件,因此“关闭文件”和“保护原始内容”是两件事:正确关闭并不会撤销已经发生的覆盖。
选择文件模式与字符编码
| 模式 | 用途 | 目标已存在或不存在时 |
|---|---|---|
| r | 读取 | 不存在则报错 |
| w | 写入替换内容 | 已有内容被截断;不存在则创建 |
| a | 追加 | 写到末尾;不存在则创建 |
| x | 仅创建新文件 | 已经存在则报错 |
编码规定字节如何表示文字。对于 UTF-8 数据,显式传入 encoding="utf-8",让文件格式约定不依赖解释器版本和环境默认值。errors="ignore"会丢弃无法解码的部分,不能作为通用修复办法,否则原本有问题的数据可能变成看似成功但缺失的文字。
文件位置先按pathlib 路径规则核对。有关文件对象、文本与二进制模式的基础,见Python 官方文件读写教程。文本模式处理字符串;图片等原始字节数据应使用适合的二进制模式,不能直接套用文本的编码与换行处理。
完整地写入、追加并逐行读取
新建独立的可丢弃练习目录,将以下代码以 UTF-8 保存为 text_files.py。它每次运行都会用 w 重置 notes-demo.txt,不要在保存重要同名文件的位置执行。在项目虚拟环境执行 python text_files.py;若实际解释器命令是 python3,就使用 python3 text_files.py。
from pathlib import Path
path = Path("notes-demo.txt")
with path.open("w", encoding="utf-8", newline="\n") as f:
f.write("coffee:3500\n")
f.write("lunch:8000\n")
with path.open("a", encoding="utf-8") as f:
f.write("bus:2500\n")
with path.open("r", encoding="utf-8") as f:
for line in f:
print(line.rstrip("\n"))
预期终端输出:
coffee:3500
lunch:8000
bus:2500
第一次 with 使用 w 写入咖啡和午餐两条记录;第二次使用 a 追加公交记录;第三次读取并打印。write 不会自动补换行,所以字符串里显式包含 \n。每个 with 退出后,对应文件对象都会关闭,包括代码块中出现异常的情况。
原始示例第一次写入指定 newline="\n",追加时则使用默认换行规则。在 Windows 上,两段可能写入不同形式的行尾;默认文本读取会统一识别这些行尾,因此仍得到上面的三行输出。如果输出文件要求统一 LF,可给所有写入和追加操作都明确指定 newline="\n";不要把终端结果相同误认为底层字节完全相同。
区分读取位置、空白与换行
read()返回当前位置之后的内容。遍历 for line in f会逐行处理,在不需要一次载入全部内容时更合适。读到末尾后再次 read 通常得到空字符串;想重新读取,可重新打开文件,或明确使用 seek(0)回到开头。空文件和已经读完的文件不能只凭这一次空字符串区分。
strip()还会去掉两端空格和制表符。若缩进或尾部空格是数据的一部分,使用本例的 rstrip("\n")只移除指定换行字符。它移除的是末尾连续出现的这些字符,并不等于对所有换行格式都自动分析。
默认文本读取会把 CR、LF、CRLF 行尾按通用换行规则处理。若读取时指定 newline="" 保留原行尾,CRLF 中的回车可能仍留在 rstrip("\n") 后面。应结合读取设置理解结果,详细参数见Python 官方 open 参数说明。
诊断错误并保护原始文件
FileNotFoundError 时检查解析后的路径与父目录;UnicodeDecodeError 时确认数据的真实编码;PermissionError 时检查权限、文件锁和目标类型。目标其实是目录时,具体异常也可能随操作系统而异。不要把所有错误都转换成空字符串,否则“文件缺失”“读取失败”和“确实为空”将无法区分。
对于重要内容,先备份,再考虑写入单独临时文件、验证后替换目标的流程,并明确失败后如何保留或恢复数据。本例的 with 负责关闭,不保证事务回滚、文件完整性或并发安全;在 w 打开后发生错误,旧内容也可能已经丢失。
- 保留原始代码,在独立目录运行两次,确认文件仍只有三条记录,因为每次首先重置。
- 仅将第一次打开的 w 改为 a,使用另一个新练习目录连续运行两次,第二次应累计六条记录。这说明追加模式不会自动判断哪些记录重复。
- 恢复 w 后在练习目录重新运行,应恢复三条记录。检查文件实际内容,不要用真实业务文件试验覆盖行为。




