python怎么写csv文件

用Python写CSV最推荐内置csv模块,正确处理特殊字符;支持writer.writerows写列表数据、DictWriter写字典数据,需指定newline=''和utf-8-sig编码防乱码,追加用'a'模式。

用 Python 写 CSV 文件最常用、最推荐的方式是使用内置的 csv 模块,它能正确处理逗号、换行、引号等特殊字符,避免手动拼接出错。

基础写法:写入多行数据

适合写入列表组成的表格数据(比如每行是一个 list):

  • csv.writer 创建写入器对象
  • writerow() 写单行,writerows() 写多行
  • 打开文件时务必指定 mode='w', newline=''(Windows 下尤其重要,否则会多空行)
import csv

data = [
['姓名', '年龄', '城市'],
['张三', 25, '北京'],
['李四', 30, '上海']
]

with open('output.csv', 'w', newline='') as f:
writer = csv.writer(f)
writer.writerows(data)

写入字典数据(更直观)

当数据是键值对(比如从 API 或数据库读来的记录),用 csv.DictWriter 更自然:

  • 需提前指定 fieldnames(列名顺序)
  • 调用 writeheader() 可自动写表头
  • 每条记录传一个字典,键名需与 fieldnames 一致
import csv

records = [
{'姓名': '王五', '年龄': 28, '城市': '广州'},
{'姓名': '赵六', '年龄': 32, '城市': '深圳'}
]

with open('people.csv', 'w', newline='') as f:
writer = csv.DictWriter(f, fieldnames=['姓名', '年龄', '城市'])
writer.writeheader() # 写表头
writer.writerows(records)

注意编码和分隔符(中文/特殊需求)

写中文 CSV 时,常需指定 encoding='utf-8-sig',让 Excel 能正常识别中文:

  • utf-8-sig 会在文件开头加 BOM,Excel 打开不乱码
  • 如需用分号或制表符代替逗号,传入 delimiter=';'delimiter='\t'
with open('cn.csv', 'w', newline='', encoding='utf-8-sig') as f:
writer = csv.writer(f, delimiter=';')
writer.writerow(['苹果', '香蕉', '橙子'])

追加写入(不覆盖原文件)

如果想在已有 CSV 文件末尾添加新行,把 'w' 改成 'a'(append 模式)即可:

  • 注意:追加时一般不再写表头,除非你确定文件为空
  • 仍要保留 newline='' 和合适的 encoding
with open('log.csv', 'a', newline='', encoding='utf-8-sig') as f:
writer = csv.writer(f)
writer.writerow(['2025-04-01', '登录成功', 'user_123'])

基本上就这些。不需要装额外包,标准库开箱即用,安全又可靠。