当前位置：首页 > news >正文

python中CSV模块详解

news 2026/4/8 4:29:20

Python 中的 csv 模块用于读写 CSV（Comma-Separated Values）文件，这是一种常用的文件格式，用于存储表格数据，如电子表格或数据库中的数据。CSV 文件通常由逗号分隔的字段组成，每行代表数据表中的一行。

基本读取操作
使用 csv.reader 读取 CSV 文件时，需指定文件对象（以文本模式打开，推荐使用 newline='' 避免空行问题）。读取结果按行返回列表，每个元素对应一个字段。例如：

import csv
with open('data.csv', mode='r', encoding='utf-8-sig') as file:
csv_reader = csv.reader(file)
for row in csv_reader:
print(row) # 输出每行数据列表

基本写入操作
使用 csv.writer 将数据写入 CSV 文件。数据需以列表或元组形式组织，模块自动处理分隔符和引号。例如：

import csv
data = [['姓名', '年龄'], ['张三', 25], ['李四', 30]]
with open('output.csv', mode='w', encoding='utf-8-sig', newline='') as file:
csv_writer = csv.writer(file)
csv_writer.writerows(data) # 批量写入多行

字典形式读写
对于更直观的操作，可使用 csv.DictReader 和 csv.DictWriter，以字典形式处理数据（键为表头字段）。例如：

import csv
# 读取时
with open('data.csv', mode='r', encoding='utf-8-sig') as file:
dict_reader = csv.DictReader(file)
for row in dict_reader:
print(row['姓名'], row['年龄']) # 直接通过键访问字段

# 写入时
fieldnames = ['姓名', '年龄']
with open('output.csv', mode='w', encoding='utf-8-sig', newline='') as file:
dict_writer = csv.DictWriter(file, fieldnames=fieldnames)
dict_writer.writeheader() # 写入表头
dict_writer.writerow({'姓名': '王五', '年龄': 28})

高级参数与场景
‌自定义分隔符‌：通过 delimiter 参数指定分隔符（如制表符 \t 或分号 ;），适用于非标准 CSV 文件。‌
‌追加模式‌：写入时使用 mode='a' 可追加数据到文件末尾，避免覆盖原有内容。‌
‌错误处理‌：字段包含分隔符或换行时，模块自动用引号包裹，无需手动处理复杂情况。‌
注意事项
文件编码建议使用 utf-8-sig 以正确处理中文。‌
大文件读取时推荐逐行遍历以节省内存；小文件可一次性读取为列表。‌
写入模式 mode='w' 会覆盖文件，如需保留原内容应使用 mode='a'

4. 自定义分隔符和引号处理
默认情况下，csv 模块使用逗号作为分隔符，双引号作为字段的引号。你可以通过传递参数来改变这些设置：

with open('example.csv', 'w', newline='') as file:
writer = csv.writer(file, delimiter=';', quotechar="'", quoting=csv.QUOTE_MINIMAL)
writer.writerow(['Name', 'Age', 'City']) # 使用分号分隔，单引号引号字段（如果需要）
5. 处理大文件和性能优化
对于大文件，推荐使用 csv.reader 和 csv.DictReader 的迭代器功能，这样可以避免一次性将整个文件内容加载到内存中：

with open('large_file.csv', 'r') as file:
reader = csv.reader(file)
for row in reader:
# 处理每一行数据，不会一次性加载整个文件到内存中
pass
6. 处理编码问题
当处理包含非ASCII字符的CSV文件时，需要指定正确的编码：

with open('example.csv', 'r', encoding='utf-8') as file:
reader = csv.reader(file)
for row in reader:
print(row) # 使用 UTF-8 编码读取文件内容，适用于包含中文等字符的文件
通过上述方法，你可以有效地使用 Python 的 csv 模块来读写 CSV 文件。