Python csv.DictReader 多余列时 restkey 怎么用

供应方在 CSV 末尾临时追加一列时，csv.DictReader 不会立刻报错，但如果没有配置 restkey，那些多出来的值会落到键为 None 的字段里。要保留异常字段，直接给它一个明确的键；再配合 restval 处理缺列，就能把“多出来”和“少了”分开。

官方文档：https://docs.python.org/3/library/csv.html

先看清 DictReader 如何处理列数不一致

假设表头只有 order_id,amount,currency，某一行却多出 note,source 两列。DictReader 会把前三个值映射到表头，多出来的值组成列表。如果不设置 restkey，这个列表默认挂在 None 键下；这对调试可以，但不适合稳定的导入协议。

因此，第一步不是把异常列截掉，而是先给异常数据留下可观察的位置：

import csv

with open("orders.csv", newline="", encoding="utf-8") as source:
    # 用明确键名接住表头之外的字段，避免异常数据落到 None
    reader = csv.DictReader(
        source,
        restkey="_extra",
        restval="",
    )
    for row in reader:
        print(row["order_id"], row["_extra"])

这里的 _extra 通常是列表；没有多余字段的行不会凭空产生一组额外值。文件用 newline="" 打开，是因为 csv 模块自己负责换行处理，避免跨平台换行或引号内换行造成误读。

用 restkey 留住异常列，而不是静默丢弃

生产导入更适合把“正常业务字段”和“协议外字段”放在同一行记录中。这样供应方新增列时，主流程仍能继续，但监控和复核可以看到变化：

import csv

def read_orders(path):
    with open(path, newline="", encoding="utf-8") as source:
        # restval 处理缺列，restkey 处理多列，两者职责不同
        reader = csv.DictReader(source, restkey="_extra", restval=None)
        for row in reader:
            extra = row.pop("_extra", [])
            # 空列表代表没有多余列，不要把正常行标成异常
            yield row, extra

for order, extra in read_orders("orders.csv"):
    if extra:
        print("发现协议外字段：", extra)
    # 业务字段照常处理，异常字段另行记录或进入隔离区

不要直接写成 row["_extra"] 后假定它永远存在；使用 pop(..., []) 可以让正常行和异常行都走同一条循环。若异常列代表供应方版本变更，可以记录原始列表；若它可能含有敏感内容，则应在日志里只记录数量、列名或哈希。

缺失字段、空字段和多余字段要分开判断

restval 只在一行字段数量少于表头时生效。例如 amount 缺失会得到 None，但 CSV 中明确写出的空单元格通常仍是空字符串。导入校验不要只写 if not row["amount"]，否则会把缺失、空值和合法的字符串零混为一谈。

如果导入协议要求严格列数，可以把 extra 非空视为坏行；如果协议允许向后兼容，则保留它并增加告警。关键是策略要显式写出来，而不是依赖 None 键的默认行为。

导入前用这份清单复查

先确认表头是否由文件首行提供，还是通过 fieldnames 显式指定；显式指定时，首行会作为普通数据行参与读取。然后核对编码、分隔符、引号规则和供应方是否会在单元格内放换行。最后决定异常字段是放行、记录还是拒绝，并为每条异常保留行号。

相关问题

没有设置 restkey 时，多余字段去哪了？

默认使用键 None 保存多余值，值本身是列表。建议生产代码使用有意义的键名，便于校验和序列化。

restval 能把空单元格变成默认值吗？

它主要处理“字段数量不足”。已经存在但内容为空的单元格仍需要单独清洗和校验。

应该直接丢弃多余字段吗？

只有协议明确允许丢弃时才这样做。更稳妥的方式是保留原始列表并记录行号，再根据业务规则决定是否入库。

小结：restkey 解决的是多余列的去处，restval 解决的是缺失列的填充值。把两者和空字符串判断分开，CSV 导入才能在供应方追加字段时保持可追踪。