在Python中处理CSV文件时，csv模块提供的DictReader和DictWriter类是非常实用的工具，它们可以将CSV的每一行数据映射为字典，避免通过索引访问列值带来的可读性问题，大幅降低代码维护成本。
DictReader的基本用法
DictReader会将CSV文件的第一行作为字典的键，后续每一行对应一个字典，字典的键就是表头的内容，值就是对应行的列值。使用DictReader读取CSV文件不需要手动处理表头，直接遍历对象就能获取每一行的字典数据。
假设我们有一个名为user_info.csv的文件，内容如下：
name,age,city 张三,25,北京 李四,30,上海 王五,28,广州
使用DictReader读取该文件的代码如下：
import csv
# 读取CSV文件
with open("user_info.csv", "r", encoding="utf-8") as f:
# 创建DictReader对象
reader = csv.DictReader(f)
# 遍历每一行数据，每一行都是字典
for row in reader:
print(f"姓名：{row['name']}，年龄：{row['age']}，城市：{row['city']}")
运行上述代码会输出每一行的用户信息，不需要通过索引0、1、2来访问列值，代码的可读性更强。如果CSV文件没有表头，可以在创建DictReader时通过fieldnames参数手动指定键名：
import csv
# 无表头的CSV文件内容示例
# 张三,25,北京
# 李四,30,上海
with open("user_info_no_header.csv", "r", encoding="utf-8") as f:
# 手动指定键名
fieldnames = ["name", "age", "city"]
reader = csv.DictReader(f, fieldnames=fieldnames)
for row in reader:
print(row)
DictWriter的基本用法
DictWriter的作用是将字典数据写入CSV文件，需要提前指定表头对应的键名，写入时会自动将字典中对应键的值提取出来，按照表头顺序写入文件。
使用DictWriter写入数据的基本步骤如下：首先指定表头字段，创建DictWriter对象，然后先写入表头，再写入每一行字典数据。
下面是一个将用户字典列表写入CSV文件的示例：
import csv
# 待写入的字典数据
user_list = [
{"name": "张三", "age": "25", "city": "北京"},
{"name": "李四", "age": "30", "city": "上海"},
{"name": "王五", "age": "28", "city": "广州"}
]
# 指定CSV的表头字段
fieldnames = ["name", "age", "city"]
with open("new_user_info.csv", "w", encoding="utf-8", newline="") as f:
# 创建DictWriter对象
writer = csv.DictWriter(f, fieldnames=fieldnames)
# 写入表头
writer.writeheader()
# 写入多行数据
writer.writerows(user_list)
# 也可以逐行写入，使用writerow方法
# for user in user_list:
# writer.writerow(user)
这里需要注意，打开文件时建议添加newline=""参数，避免写入CSV时出现多余的空行，这是Windows系统下处理CSV文件的常见注意事项。
DictReader和DictWriter的常用参数
DictReader常用参数
- f：文件对象，必须是支持迭代的文本文件
- fieldnames：可选参数，指定字典的键名，如果不指定则使用CSV第一行的表头作为键名
- restkey：可选参数，当CSV行的列数多于fieldnames的长度时，多出来的列值会放到这个键对应的列表中
- restval：可选参数，当CSV行的列数少于fieldnames的长度时，缺少的列值会用这个参数指定的值填充
DictWriter常用参数
- f：文件对象，用于写入数据的文本文件
- fieldnames：必填参数，指定CSV的表头，也是字典的键名
- extrasaction：可选参数，默认值为raise，当字典中存在fieldnames没有的键时，会抛出ValueError；如果设置为ignore，则会忽略这些多余的键
- delimiter：可选参数，指定CSV的分隔符，默认是逗号，也可以设置为其他字符比如制表符
实际应用场景示例
假设我们需要从一个CSV文件中读取用户信息，筛选出年龄大于26岁的用户，再将这些用户的信息写入新的CSV文件，使用DictReader和DictWriter可以很方便地实现这个需求：
import csv
# 读取原始文件，筛选年龄大于26岁的用户
filtered_users = []
with open("user_info.csv", "r", encoding="utf-8") as f:
reader = csv.DictReader(f)
for row in reader:
# 将age转换为整数再比较
if int(row["age"]) > 26:
filtered_users.append(row)
# 将筛选后的用户写入新文件
fieldnames = ["name", "age", "city"]
with open("filtered_user_info.csv", "w", encoding="utf-8", newline="") as f:
writer = csv.DictWriter(f, fieldnames=fieldnames)
writer.writeheader()
writer.writerows(filtered_users)
print("筛选完成，结果已写入filtered_user_info.csv")
这个示例中，读取到的每一行数据本身就是字典，不需要额外转换结构，直接筛选后就可以交给DictWriter写入新文件，整个过程逻辑清晰，代码简洁。
使用注意事项
1. 读取和写入文件时都要注意指定正确的编码，比如中文内容常用utf-8编码，避免出现乱码问题。
2. 使用DictWriter写入文件时，字典的键必须和fieldnames中指定的键完全一致，否则会出现数据缺失或者报错。
3. 如果CSV文件的分隔符不是逗号，需要在创建DictReader或DictWriter时通过delimiter参数指定对应的分隔符。
4. DictReader读取到的所有值都是字符串类型，如果需要数值类型的数据，需要手动进行类型转换。
PythonCSVdictreaderdictwriter文件读写修改时间：2026-07-03 04:12:31