api 读写文件

API 读写文件详解

文件操作基础概念

术语	说明
文件路径	指向文件的位置，分为绝对路径（如 C:file.txt）和相对路径（如 ./data.csv）
文件模式	定义文件操作类型：'r' 读取、'w' 写入（覆盖）、'a' 追加、'b' 二进制模式
文件句柄	通过 open() 函数返回的对象，用于后续读写操作
编码格式	文本文件需指定编码（如 utf-8），二进制文件无需编码

---

Python 文件读取 API

基本读取方法

# 读取整个文件内容
with open("example.txt", "r", encoding="utf-8") as f:
    content = f.read()  # 一次性读取全部内容
# 逐行读取
with open("example.txt", "r", encoding="utf-8") as f:
    for line in f:
        print(line.strip())  # 去除换行符

高级读取技巧

方法	说明	适用场景
read(size)	按指定字节数读取	控制内存占用
readline()	逐行读取	处理长文件
readlines()	读取所有行到列表	小文件快速加载

---

Python 文件写入 API

基础写入方法

# 覆盖写入模式
with open("output.txt", "w", encoding="utf-8") as f:
    f.write("Hello World
")
    f.write("第二行内容
")
# 追加写入模式
with open("output.txt", "a", encoding="utf-8") as f:
    f.write("追加的新内容
")

写入优化方案

场景	解决方案
大量数据写入	使用 writelines() 方法批量写入列表数据
实时日志记录	保持文件句柄持续打开，配合 flush=True 参数
二进制文件写入	使用 'wb' 模式，写入 bytes 类型数据

---

异常处理与最佳实践

常见异常类型

异常类型	触发场景	解决方案
FileNotFoundError	文件不存在	检查路径或使用异常捕获
PermissionError	无写入权限	修改文件权限或更换目录
UnicodeDecodeError	编码不匹配	显式指定正确编码格式

推荐代码结构

try:
    with open("data.txt", "r", encoding="utf-8") as f:
        data = f.read()
except FileNotFoundError:
    print("文件不存在，请检查路径")
except Exception as e:
    print(f"发生未知错误：{e}")

---

进阶应用场景

JSON 文件操作

import json
# 写入 JSON 数据
with open("config.json", "w") as f:
    json.dump({"name": "Alice", "age": 30}, f)
# 读取 JSON 数据
with open("config.json", "r") as f:
    data = json.load(f)

CSV 文件处理

import csv
# 写入 CSV 文件
with open("data.csv", "w", newline='') as f:
    writer = csv.writer(f)
    writer.writerow(["Name", "Age"])
    writer.writerow(["Bob", 25])
# 读取 CSV 文件
with open("data.csv", "r") as f:
    reader = csv.reader(f)
    for row in reader:
        print(row)

---

常见问题与解答（Q&A）

Q1：如何处理超大文件（如 GB 级别）？

A：

• 逐行读取：使用 for line in f 代替 read()，避免内存溢出
• 分块处理：结合 read(chunk_size) 每次处理固定大小数据
• 内存映射：使用 mmap 模块实现文件内存映射（高级用法）

Q2：为什么写入文件后内容没有立即显示？

A：

• 缓冲区问题：Python 默认对文件操作进行缓存，需手动调用 f.flush() 刷新缓冲区
• 延迟关闭：未正确关闭文件句柄可能导致内容未写入磁盘，建议始终使用 with 语句管理文件上下文

到此，以上就是小编对于“api 读写文件”的问题就介绍到这了，希望介绍的几点解答对大家有用，有任何问题和不懂的，欢迎各位朋友在评论区讨论，给我留言。