python中怎么把字典写入CSV文件？

使用DictWriter可自动处理字典键到CSV列的映射，支持定义列序、忽略多余键（extrasaction=’ignore’）、填充缺失值（restval=’N/A’），并避免手动转换数据结构；配合encoding=’utf-8’解决中文乱码，newline=”防止空行，提升代码健壮性与可维护性。

在Python中，要将字典数据写入CSV文件，最直接且推荐的方式是使用内置

csv

模块中的

DictWriter

类。这个类专门为处理字典数据而设计，它能让你方便地将字典的键映射为CSV的列头，并自动处理数据的写入，省去了手动处理列顺序和缺失值的麻烦。

解决方案

import csv
# 假设我们有一些字典数据，每个字典代表一行记录
data = [
{'name': '张三', 'age': 30, 'city': '北京'},
{'name': '李四', 'age': 24, 'city': '上海'},
{'name': '王五', 'age': 35, 'city': '广州', 'occupation': '工程师'} # 注意这里王五多了一个'occupation'键
]
# 定义CSV文件的列名。这个列表的顺序决定了CSV文件中列的顺序，
# 并且它也决定了哪些字典键会被写入。
fieldnames = ['name', 'age', 'city', 'occupation', 'email'] # 甚至可以包含一些字典中没有的键
# 指定输出文件路径
output_file = 'my_records.csv'
try:
# 以写入模式打开文件，并指定newline=''以避免空行问题，encoding='utf-8'处理中文等字符
with open(output_file, 'w', newline='', encoding='utf-8') as csvfile:
# 创建DictWriter实例。fieldnames参数是必需的。
# extrasaction='ignore' 会忽略字典中存在但fieldnames中未定义的键。
# restval='N/A' 会用 'N/A' 填充字典中缺失但fieldnames中定义的键。
writer = csv.DictWriter(csvfile, fieldnames=fieldnames,
extrasaction='ignore', restval='N/A')
writer.writeheader() # 写入CSV文件的标题行（即fieldnames）
# 写入所有字典数据
writer.writerows(data)
print(f"数据已成功写入 {output_file}")
except IOError as e:
print(f"写入文件时发生I/O错误: {e}")
except Exception as e:
print(f"发生未知错误: {e}")

为什么使用

DictWriter

而不是

writer

？它有什么优势？

在Python的

csv

模块里，

DictWriter

和

writer

都是用来写入CSV的，但它们针对的数据结构不同，因此在处理字典数据时，

DictWriter

的优势就显得尤为突出。我个人在处理实际项目数据时，如果数据源是字典列表，几乎总是首选

DictWriter

。

csv.writer

期望你提供一个列表（或元组）作为每一行的数据。这意味着你需要手动将字典的键值对转换成一个有序的列表，并且还得确保每个字典的键都存在，或者至少处理好缺失值，否则很容易出现

KeyError

。想象一下，如果你有十几个字段，每个字段的顺序都得严格对应，一旦数据结构有点变化，比如某个字典少了一个字段，你的代码就可能崩掉，或者写入的数据错位。这在数据源不完全规整时简直是噩梦。

而

DictWriter

则完全是为字典而生。它最核心的优势在于，你只需告诉它你的CSV文件应该有哪些列（通过

fieldnames

参数），以及这些列的顺序。然后，它会自己去匹配你的字典数据。如果字典里有

fieldnames

中没有的键，它会根据你设置的

extrasaction

参数来处理（默认是抛出错误，但通常我们会设为

'ignore'

，让它悄悄忽略掉）。如果字典里缺少

fieldnames

中定义的某个键，它也会根据

restval

参数（默认是空字符串）来填充，避免了手动检查和补齐的繁琐工作。

立即学习“Python免费学习笔记（深入）”；

这种“声明式”的写入方式，让代码更加健壮和可读。我不用担心数据的内部顺序，只需要定义好输出的结构，剩下的交给

DictWriter

就好。这不仅减少了出错的可能性，也让代码在面对数据结构微小变动时，有了更好的弹性。比如，你新增了一个字段，只需要在

fieldnames

里加一下，旧的数据也能正常写入，只是那个新字段会是空值，完全符合预期。

如何处理字典中键不一致的情况，比如有的字典有额外字段？

这正是

DictWriter

的强大之处，也是我特别喜欢它的一个原因。实际数据往往不是那么规整，有的字典可能多几个键，有的又少几个键，这在日志分析、API响应处理中太常见了。

DictWriter

提供了

extrasaction

和

restval

两个参数来优雅地处理这些“不一致”。

首先，

fieldnames

列表是你的“圣经”，它定义了CSV文件中最终会出现哪些列，以及它们的顺序。

• 处理额外字段 (

  extrasaction

  ):
  如果你的字典中包含了一些

  fieldnames

  里没有定义的键（也就是“额外字段”），

  DictWriter

  默认的行为是抛出一个

  ValueError

  ，告诉你“嘿，你这个字典里有我不知道的键！”。这在某些场景下是好事，可以提醒你数据结构可能不符合预期。但更多时候，我们希望它能“聪明”一点，直接忽略掉这些额外的字段。
  这时，你可以将

  DictWriter

  的

  extrasaction

  参数设置为

  'ignore'

  。这样，那些不在

  fieldnames

  列表中的键值对，就会被悄无声息地忽略掉，不会写入CSV文件，也不会导致程序中断。这对于处理“超集”数据（即字典可能包含比你想要的更多信息）非常有用。

• 处理缺失字段 (

  restval

  ):
  反过来，如果你的字典中缺少了

  fieldnames

  中定义的某个键，

  DictWriter

  会如何处理呢？默认情况下，它会在CSV中对应的单元格写入一个空字符串。但你也可以通过

  restval

  参数来自定义这个缺失值。比如，你可以设置为

  'N/A'

  、

  'None'

  或者任何你觉得有意义的占位符。这让CSV文件看起来更整洁，也方便后续的数据分析，因为你可以一眼看出哪些数据是缺失的。

这两个参数结合使用，让

DictWriter

在处理复杂、不完全一致的字典数据时，展现出极高的灵活性和健壮性。你不需要写额外的逻辑去预处理数据，只需要在创建

DictWriter

时声明你的处理策略即可。这大大简化了代码，也降低了维护成本。

写入CSV时常见的编码问题和

newline

参数的意义是什么？

在Python中处理CSV文件，尤其是涉及到非英文字符（比如中文）时，编码问题和

newline

参数几乎是绕不开的两个坑。我见过太多新手因为这两个问题而抓狂。

• 编码问题 (

  encoding='utf-8'

  ):
  这是最常见的问题之一。当你尝试将包含中文、日文、德文特殊字符等非ASCII字符的字典写入CSV文件时，如果没有明确指定编码，Python可能会使用系统默认编码（在Windows上通常是GBK或cp936，而不是UTF-8）。这会导致

  UnicodeEncodeError

  错误，或者更糟糕的是，文件写入成功但打开后发现是乱码。
  解决方案是： 始终在

  open()

  函数中明确指定

  encoding='utf-8'

  。UTF-8是目前最通用的字符编码标准，它支持世界上几乎所有的字符集，并且被广泛应用于互联网和各种操作系统。这样可以确保你的CSV文件在不同的系统和软件（如Excel、文本编辑器）中都能正确显示。
  有时候，为了让CSV文件在某些版本的Excel中打开时不乱码，可能需要使用

  encoding='utf-8-sig'

  。

  utf-8-sig

  会在文件开头添加一个BOM（Byte Order Mark），这能帮助Excel正确识别UTF-8编码。但在大多数现代应用场景下，

  utf-8

  就足够了。

• newline=''

  参数的意义:
  这可能是Python

  csv

  模块中最容易被忽略，但也最关键的一个参数。它的作用是禁用Python文件对象在文本模式下默认进行的“通用换行符转换”（Universal Newline Translation）。
  具体来说，当你在文本模式下（即不带

  'b'

  ）打开文件时，Python会根据操作系统的不同，自动将文件中的

  \n

  （换行符）转换成

  \r\n

  （Windows）或保持

  \n

  （Unix/Linux/macOS）。
  然而，

  csv

  模块有它自己处理行结束符的逻辑。如果

  newline=''

  没有被设置，Python的文件对象会先将你写入的

  \n

  转换成

  \r\n

  ，然后

  csv

  模块又会再添加一个它自己的行结束符（通常也是

  \r\n

  ），结果就是你的CSV文件里每一行数据之间会多出一个空行，看起来就像是“双倍行距”一样，非常不美观，也可能影响后续处理。
  解决方案是： 始终在

  open()

  函数中将

  newline

  参数设置为空字符串

  newline=''

  。这告诉Python，不要对文件中的换行符做任何自动转换，让

  csv

  模块自己全权负责处理行结束符。这样可以确保CSV文件在所有操作系统上都以正确且一致的格式写入，避免了多余的空行。这是一个最佳实践，几乎在所有涉及

  csv

  模块的文件操作中都应该使用。