python中怎么把字典写入CSV文件？-Python教程-PHP中文网

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

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

在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
```
登录后复制
模块的文件操作中都应该使用。