使用Python进行文件读写的API或方法及其注意事项

本文总结了Python文件读写的核心API及注意事项。

---

主要内容包括：

1）文件打开与关闭方法，推荐使用with语句自动管理资源；

2）文件读取方法，如read()、readline()等，注意大文件应使用迭代器方式；

3）文件写入方法及操作模式说明；

4）文件指针操作和常用辅助参数设置。

---

最佳实践建议：始终使用with语句，明确指定编码，根据场景选择合适方法（如大文件用迭代器）。

---

常见错误包括编码问题、文件指针位置错误等，可通过指定正确编码、seek(0)重置指针等方式解决。

使用Python进行文件读写的API或方法及其注意事项

以下是 Python 文件读写的核心 API 及注意事项总结表：

一、文件打开与关闭

二、文件读取方法

三、文件写入方法

四、文件操作模式

五、文件指针操作

六、常用辅助操作

七、最佳实践总结

八、常见错误与解决方案

九、典型完整示例

python

# 推荐的标准写法 with open('file.txt', 'r', encoding='utf-8') as f: for line in f: # 逐行读取，内存友好 print(line.strip()) # 写入示例 with open('output.txt', 'w', encoding='utf-8') as f: f.write('第一行\n') f.writelines(['第二行\n', '第三行\n']) # 无需手动 close()

这个表格涵盖了 Python 文件操作的主要 API 和使用要点，建议在实际开发中优先使用with语句并明确指定编码。

补充：文件操作模式

以下是 Python 文件操作模式的完整补充，包括所有组合模式及详细说明：

一、基础模式完整版

二、二进制模式组合

三、特殊模式组合

四、模式详细行为对比

4.1 文件指针位置详解

python

# 演示不同模式的指针位置 with open('test.txt', 'w') as f: f.write('1234567890') # r+ 模式：指针在开头 with open('test.txt', 'r+') as f: print(f.tell()) # 0 f.write('ABC') f.seek(0) print(f.read()) # ABC4567890 # a+ 模式：指针在末尾 with open('test.txt', 'a+') as f: print(f.tell()) # 10（文件末尾） f.write('XYZ') f.seek(0) print(f.read()) # ABC4567890XYZ

4.2 读写操作行为差异

4.3 错误处理行为

python

# 不同模式对错误的处理 import os # 模式 'x' - 文件存在时报错 try: with open('existing.txt', 'x') as f: f.write('data') except FileExistsError: print("文件已存在，无法创建") # 模式 'r' - 文件不存在时报错 try: with open('not_exist.txt', 'r') as f: data = f.read() except FileNotFoundError: print("文件不存在") # 模式 'w' - 自动创建，不报错 with open('new_file.txt', 'w') as f: f.write('自动创建成功')

五、平台差异性说明

六、实际应用场景示例

6.1 配置文件读写

python

# 使用 'r' 读取配置 def read_config(): with open('config.txt', 'r', encoding='utf-8') as f: return dict(line.strip().split('=') for line in f) # 使用 'w' 保存配置 def save_config(config): with open('config.txt', 'w', encoding='utf-8') as f: for key, value in config.items(): f.write(f"{key}={value}\n")

6.2 日志文件追加

python

import datetime def log_message(msg): # 'a' 模式自动追加，不会覆盖历史日志 with open('app.log', 'a', encoding='utf-8') as f: timestamp = datetime.datetime.now() f.write(f"[{timestamp}] {msg}\n")

6.3 二进制文件处理

python

# 复制图片（二进制模式） def copy_image(src, dst): with open(src, 'rb') as source: with open(dst, 'wb') as target: # 分块复制，避免内存爆炸 while chunk := source.read(8192): target.write(chunk) # 修改二进制文件特定位置 def patch_binary(filepath, offset, new_bytes): with open(filepath, 'r+b') as f: f.seek(offset) f.write(new_bytes)

6.4 临时文件安全创建

python

# 使用 'x' 模式避免覆盖 def safe_save(data, filename): try: with open(filename, 'x', encoding='utf-8') as f: f.write(data) print(f"成功创建 {filename}") except FileExistsError: print(f"文件 {filename} 已存在，拒绝覆盖") # 可以生成新文件名 base, ext = os.path.splitext(filename) new_name = f"{base}_new{ext}" return safe_save(data, new_name)

6.5 文件内容原地修改

python

# 使用 'r+' 模式修改文件特定行 def replace_line(filename, line_num, new_content): with open(filename, 'r+', encoding='utf-8') as f: lines = f.readlines() if 0 <= line_num < len(lines): lines[line_num] = new_content + '\n' f.seek(0) f.writelines(lines) f.truncate() # 截断多余内容

6.6 CSV 文件处理

python

import csv # 读取 CSV（文本模式） def read_csv(filename): with open(filename, 'r', newline='', encoding='utf-8') as f: return list(csv.reader(f)) # 写入 CSV（文本模式） def write_csv(filename, data): with open(filename, 'w', newline='', encoding='utf-8') as f: writer = csv.writer(f) writer.writerows(data)

七、高级模式与标志位（底层 os.open）

八、性能对比与选择建议

九、常见陷阱与解决方案

十、完整决策树

python

# 选择文件模式的决策逻辑 def choose_mode(read_needed, write_needed, append_mode, binary_mode, safe_create): if binary_mode: mode_base = 'b' else: mode_base = 't' # 可省略 if read_needed and write_needed: if safe_create: return 'w+' + mode_base # 安全创建但会清空 elif append_mode: return 'a+' + mode_base else: return 'r+' + mode_base elif read_needed: return 'r' + mode_base elif write_needed: if safe_create: return 'x' + mode_base elif append_mode: return 'a' + mode_base else: return 'w' + mode_base else: raise ValueError("至少需要读或写权限") # 使用示例 print(choose_mode(True, False, False, False, False)) # 'r' print(choose_mode(True, True, True, False, False)) # 'a+' print(choose_mode(False, True, False, True, False)) # 'wb' print(choose_mode(False, True, False, False, True)) # 'x'

这个补充涵盖了 Python 文件操作模式的所有细节，建议根据具体场景选择合适的模式组合。

错误示例：错误分析

#读文件 with open("C:\\Users\\86178\\Desktop\\aaa.txt",'r',encoding="utf-8") as f: con=f.read()#将文本的内容作为一个整体字符串，读出来 con1=f.readline() con2 = f.readlines()#把文本每行的内容 作为一个元素 放到列表里面 print(con) #输出 # aaa # bbb # ccc print(con1)#换行？ print(con2)#[]？ f.close()#关闭该线程 关闭文件

你的代码存在一个关键问题：在调用了f.read()之后，文件指针已经移动到了文件末尾，因此后续的f.readline()和f.readlines()无法再读取到任何内容。

问题分析

1. f.read()读取整个文件，指针移到最后

2. f.readline()从当前位置（文件末尾）读取，返回空字符串''

3. f.readlines()同样从末尾读取，返回空列表[]

4. 你看到的print(con1)输出空行，是因为打印了空字符串后自动换行

5. f.close()其实可以省略（with语句会自动关闭）

修正后的代码

方案一：只使用一种读取方式

python

with open("C:\\Users\\86178\\Desktop\\aaa.txt", 'r', encoding="utf-8") as f: con = f.read() # 整体读取 print(con)

方案二：分别读取（需要重新打开或重置指针）

python

with open("C:\\Users\\86178\\Desktop\\aaa.txt", 'r', encoding="utf-8") as f: con = f.read() print("read()结果：") print(con) # 将指针移回文件开头 f.seek(0) con1 = f.readline() print("readline()结果：", repr(con1)) # 使用repr可以看到转义字符 con2 = f.readlines() print("readlines()结果：", con2)

方案三：分别打开文件

python

# 分别演示三种读取方式 with open("C:\\Users\\86178\\Desktop\\aaa.txt", 'r', encoding="utf-8") as f: print("1. read():") print(f.read()) with open("C:\\Users\\86178\\Desktop\\aaa.txt", 'r', encoding="utf-8") as f: print("\n2. readline():") print(repr(f.readline())) with open("C:\\Users\\86178\\Desktop\\aaa.txt", 'r', encoding="utf-8") as f: print("\n3. readlines():") print(f.readlines())

补充说明

• readline()：返回一行字符串（包含换行符\n），文件末尾返回空字符串''

• readlines()：返回所有行的列表，每行字符串包含换行符

• repr()函数可以显示字符串的真实内容，包括\n等转义字符

• seek(0)：将文件指针移动到指定位置，0表示文件开头

类似错误

with open('day_07.py','w+',encoding="utf-8") as f: f.writelines("hello world\n")#覆盖写入 con = f.read() print(con)#为什么读不出数据？ f.close()

问题在于文件指针位置！你的代码流程如下：

问题分析

python

with open('day_07.py', 'w+', encoding="utf-8") as f: f.writelines("hello world\n") # 1. 写入数据，指针在末尾（第13个字节后） con = f.read() # 2. 从末尾读取 → 读不到任何数据 print(con) # 3. 输出空字符串 f.close() # 4. with 语句会自动关闭，此行多余

关键点：

• writelines()写入后，文件指针停留在写入内容的末尾

• 此时调用read()，从末尾开始读 → 返回空字符串

解决方案

方案一：先 seek(0) 再读取

python

with open('day_07.py', 'w+', encoding="utf-8") as f: f.writelines("hello world\n") f.seek(0) # 将指针移回文件开头 con = f.read() print(con) # 输出: hello world

方案二：先写入，关闭后重新读取

python

# 先写入 with open('day_07.py', 'w', encoding="utf-8") as f: f.writelines("hello world\n") # 再读取 with open('day_07.py', 'r', encoding="utf-8") as f: con = f.read() print(con) # 输出: hello world

方案三：使用 r+ 模式（需要文件已存在）

python

# 先创建文件 with open('day_07.py', 'w', encoding="utf-8") as f: f.writelines("hello world\n") # 再读写 with open('day_07.py', 'r+', encoding="utf-8") as f: con = f.read() print(con) # 输出: hello world f.write("\n追加内容") # 在末尾追加

各模式写入后的指针位置

验证指针位置

python

# 演示指针位置变化 with open('day_07.py', 'w+', encoding="utf-8") as f: print(f"初始位置: {f.tell()}") # 0 f.writelines("hello world\n") print(f"写入后位置: {f.tell()}") # 13（假设12个字符+换行符） f.seek(0) print(f"seek(0)后位置: {f.tell()}") # 0 con = f.read() print(f"读取后位置: {f.tell()}") # 13（读完又到末尾） print(f"读取内容: {con}") # hello world

正确的 w+ 使用场景

w+模式适合以下场景：

场景1：写入后立即读取（需 seek）

python

with open('temp.txt', 'w+', encoding="utf-8") as f: # 生成数据 for i in range(10): f.write(f"第{i}行\n") # 需要读取时，先回到开头 f.seek(0) data = f.read() print(data)

场景2：清空文件后重新写入并验证

python

with open('config.txt', 'w+', encoding="utf-8") as f: f.write("new config data") f.seek(0) # 验证写入是否正确 if f.read() == "new config data": print("写入成功")

场景3：在内存中处理数据

python

# 使用 StringIO 更好，但 w+ 也可以 with open('data.txt', 'w+', encoding="utf-8") as f: # 先生成内容 lines = ["line1\n", "line2\n", "line3\n"] f.writelines(lines) # 处理这些数据 f.seek(0) processed = [line.upper() for line in f] print(processed) # ['LINE1\n', 'LINE2\n', 'LINE3\n']

其他注意事项

1. close() 是多余的

python

# with 语句会自动关闭文件，不需要手动 close() with open('day_07.py', 'w+', encoding="utf-8") as f: f.write("data") f.seek(0) print(f.read()) # 离开 with 块时自动关闭

2.writelines() 不会自动换行

python

# writelines() 不会自动添加换行符 with open('test.txt', 'w+') as f: f.writelines(["hello", "world"]) # 结果是 "helloworld" # 需要手动添加 with open('test.txt', 'w+') as f: f.writelines(["hello\n", "world\n"]) # 正确

3. 更清晰的替代方案

python

# 如果只是创建新文件并写入，用 'w' 模式 with open('day_07.py', 'w', encoding="utf-8") as f: f.writelines("hello world\n") # 单独读取 with open('day_07.py', 'r', encoding="utf-8") as f: print(f.read())

总结

你的代码读不出数据的原因：writelines()后指针在文件末尾，read()从末尾开始读导致返回空字符串。

解决方法：在读取前添加f.seek(0)将指针移回开头。

最佳实践：除非确实需要读写切换，否则建议使用单一目的的模式（'r'只读或'w'只写），代码意图更清晰。