在 Python 编程中，文件操作是一项基础且重要的技能。无论是读取配置文件、处理日志，还是进行数据持久化，都离不开对文件的读写。本文将带你从文件读取的基础操作学起，深入剖析各类方法的使用场景，并总结实战中极易踩坑的易错点，让你彻底掌握 Python 文件操作。

一、文件编码基础：理解 “翻译规则”

在开始文件操作前，必须先搞清楚文件编码的概念 —— 它就像 “翻译规则”，决定了如何将文本内容与二进制数据互相转换。
常见编码格式：
UTF-8：目前全球通用的编码格式，支持多语言（包括中文、日文、韩文等），是 Python 文件操作的推荐编码。
GBK/GB2312：中文系统常用的编码，仅支持中文及部分符号，兼容性较差。
Big5：主要用于中国台湾地区的繁体中文编码。

为什么要关注编码？如果编码格式不匹配，Python 在读取文件时会抛出UnicodeDecodeError（解码错误）。例如用utf-8编码读取一个GBK编码的文件，就会因 “翻译规则” 冲突而失败。

二、文件读取的核心方法：open()与三大读取操作

Python 通过open()函数打开文件，返回文件对象后，可通过三类方法读取内容：read()、readlines()、readline()。

1. open()函数的参数解析

open(name, mode, encoding)的三个核心参数：
name：文件路径（可包含具体目录，如"E:/新建文件夹/Python.txt"）。
mode：打开模式，“r"表示只读（read），是文件读取的默认模式；还有"w”（写入，会覆盖原文件）、“a”（追加）等。
encoding：编码格式，必须以关键字参数encoding=传递，否则会因参数位置错误报错（如TypeError: ‘str’ object cannot be interpreted as an integer）。

2. read()：按字节 / 全部读取

用法：文件对象.read(num)，num为读取的字节数；若不传入num，则读取文件全部内容。
示例：

f = open("E:/新建文件夹/Python.txt", "r", encoding="utf-8")
# 读取10个字节
print(f"读取10个字节的结果是：{f.read(10)}")
# 读取全部内容
print(f"read方法读取全部内容的结果是：{f.read()}")

易错点：读取指针会 “移动”。第一次read(10)后，指针停在第 10 字节处；若再调用read()，会从指针位置继续读取，而非从头开始。如需重置指针，需使用f.seek(0)。

3. readlines()：按行读取并封装为列表

用法：文件对象.readlines()，将文件每一行作为列表的一个元素，一次性读取全部内容。
示例：

lines = f.readlines()
print(f"lines对象的类型是：{type(lines)}")  # 输出<class 'list'>
print(f"lines对象的内容是：{lines}")

适用场景：需要对每一行进行批量操作时（如逐行分析日志）。

4. readline()：一次读取一行

用法：文件对象.readline()，每次调用只读取一行内容，多次调用可逐行读取。
示例：

line1 = f.readline()
line2 = f.readline()
line3 = f.readline()
print(f"第一行数据是：{line1}")
print(f"第二行数据是：{line2}")
print(f"第三行数据是：{line3}")

特点：读取指针随调用逐行移动，适合大文件的 “流式读取”（避免一次性加载大文件导致内存溢出）。

5. for 循环逐行读取

除了readline()，还可以用 for 循环直接遍历文件对象，实现逐行读取：

for line in f:
    print(f"每一行数据：{line}")

这种方式简洁高效，且不需要手动管理读取指针。

三、文件操作的 “收尾工作”：关闭与上下文管理器

文件操作后必须关闭文件对象，否则会导致资源泄漏。Python 提供了两种方式来保障文件关闭：

1. 手动关闭：close()方法

使用f.close()显式关闭文件：

f = open("xxx.txt", "r", encoding="utf-8")
# 一系列读取操作...
f.close()

易错点：如果代码在f.close()前抛出异常，文件将无法正常关闭。因此更推荐使用上下文管理器。

2. 自动关闭：with open语法

with open是 Python 推荐的文件操作方式，它会在代码块执行完毕后自动关闭文件，无需手动调用close()：

with open("E:/新建文件夹/Python.txt", "r", encoding="utf-8") as f:
    for line in f:
        print(f"每一行数据是：{line}")
# 代码块结束后，f自动关闭

四、实战易错点大总结

结合实际开发场景，以下是文件操作中极易踩坑的 “雷区”，务必注意：

1. 编码不匹配导致的UnicodeDecodeError

现象：读取文件时抛出UnicodeDecodeError: ‘utf-8’ codec can’t decode byte…。
原因：文件编码与encoding参数指定的编码不一致。
解决：
用记事本 / VS Code 等工具确认文件实际编码（如GBK），然后修改encoding参数：

f = open("xxx.txt", "r", encoding="gbk")

若文件是UTF-8但带 BOM 头，使用utf-8-sig编码：

f = open("xxx.txt", "r", encoding="utf-8-sig")

2. open()参数传递格式错误

现象：抛出TypeError: ‘str’ object cannot be interpreted as an integer。
原因：将encoding作为位置参数传递（open的第三个位置参数是buffering，需整数类型）。
解决：显式指定encoding=：

# 错误写法
f = open("xxx.txt", "r", "utf-8")
# 正确写法
f = open("xxx.txt", "r", encoding="utf-8")

3. 读取指针未重置导致的 “内容缺失”

现象：read()或readline()读取到的内容为空或不完整。
原因：读取指针在之前的操作中已移动到文件末尾。
解决：使用f.seek(0)将指针重置到文件开头：

f = open("xxx.txt", "r", encoding="utf-8")
f.read(10)  # 指针移动到第10字节
f.seek(0)   # 指针重置到开头
print(f.read())  # 重新读取全部内容

4. 操作 Word/Excel 等二进制文件时用文本模式读取

现象：读取.docx、.xlsx等文件时，抛出解码错误或读取内容乱码。
原因：这些是二进制格式文件，不能用普通文本读取方式（r模式）。
解决：如需处理 Word/Excel，需使用专用库（如python-docx、openpyxl），而非open()直接读取。

5. 忘记关闭文件导致资源泄漏

现象：长期运行的程序出现 “文件被占用”“资源耗尽” 等问题。
原因：未关闭文件对象，导致系统资源无法释放。
解决：强制使用with open语法，或确保f.close()在任何分支都能执行（可结合try…finally）。

五、实战案例：统计文件中特定单词出现次数

以统计文件中 “itheima” 单词出现次数为例，演示两种实现方式，巩固文件操作知识：

# 方式1：读取全部内容后用count方法统计
f = open("E:/新建文件夹/word.txt", "r", encoding="utf-8")
content = f.read()
count = content.count("itheima")
print(f"itheima在文件中出现了：{count}次")
f.close()

# 方式2：逐行读取+分割单词统计
f = open("E:/新建文件夹/word.txt", "r", encoding="utf-8")
count = 0
for line in f:
    line = line.strip()  # 去除换行和空格
    words = line.split(" ")  # 按空格分割单词
    for word in words:
        if word == "itheima":
            count += 1
print(f"itheima在文件中出现了：{count}次")
f.close()

总结

Python 文件操作的核心是open()函数与三类读取方法，而掌握编码匹配、参数格式、读取指针、资源关闭这四大易错点，能让你在实战中避免绝大多数问题。无论是简单的文本读取，还是复杂的文件分析，只要牢记这些知识点，就能轻松应对。
快去动手实践吧，从读取一个简单的.txt文件开始，逐步探索更复杂的文件操作场景！