Python 教程 / 用 csv 读写表格数据并验证金额
CSV(Comma-Separated Values,逗号分隔值)用文本保存行和字段。应使用 Python 的 csv 模块处理引号、分隔符和字段内换行,再单独验证数据类型;DictReader 读出的金额通常仍是字符串,不会自动成为整数。
不要把 CSV 当成简单的逗号切分
一个带引号的字段可以包含逗号或换行。直接 split(",") 不理解这套语法,会把同一个名称拆成几个字段。csv.reader 处理字段边界,DictReader 则用表头名称将字段映射到字典。读取成功并不意味着列数、列名和业务值都符合要求。
打开 CSV 文件时使用 newline="",让 csv 模块处理行尾。读取 UTF-8 时,utf-8-sig可以接受文件开头的 BOM(字节顺序标记),避免它混入第一个表头名称;不带 BOM 的 UTF-8 文件也可按此编码读取。行为与参数见Python 官方 csv 文档。
本例使用默认逗号分隔格式。有些工具导出分号或其他分隔符,应先核对实际格式并配置相应 dialect 或 delimiter,不能只看文件扩展名为 .csv 就认定格式相同。文件打开与编码的基础见文本文件读写。
写入带逗号的名称并计算合计
在独立的可丢弃练习目录,将以下完整内容以 UTF-8 保存为 csv_demo.py。它会覆盖 expenses-demo.csv,因此不要使用真实业务文件所在的同名路径。在项目环境执行 python csv_demo.py;如果核对过的解释器命令是 python3,就使用 python3 csv_demo.py。本例无第三方依赖。
import csv
from pathlib import Path
path = Path("expenses-demo.csv")
with path.open("w", encoding="utf-8", newline="") as f:
writer = csv.DictWriter(f, fieldnames=["name", "amount"])
writer.writeheader()
writer.writerows([{ "name": "lunch, team", "amount": 8000}, {"name": "bus", "amount": 2500}])
total = 0
with path.open(encoding="utf-8-sig", newline="") as f:
reader = csv.DictReader(f)
if reader.fieldnames != ["name", "amount"]:
raise ValueError("unexpected header")
for row in reader:
total += int(row["amount"])
print(row["name"])
print("total:", total)
预期输出:
lunch, team
bus
total: 10500
第一条名称 lunch, team 包含逗号,但应仍属于一个 name 字段;两条金额分别为 8000 和 2500。DictWriter 按指定 fieldnames 顺序写入表头和数据。重新打开后,程序要求表头严格等于 name、amount,再将金额传入 int 并累加为 10500。
用文本编辑器查看文件,会看到名称被引号包围。不要删除引号来“修复多出的逗号”;再用 csv.reader 读回后,每条记录仍应只有两个字段,名称值仍是 lunch, team。终端显示名称时不带 CSV 引号,是因为它已经恢复成普通字符串。
明确金额格式、列数与记录编号
空金额、8,000、8000元或 8.5 不能全部直接交给 int。先定义允许整数还是小数、是否允许负数、空值如何处理,再按该规则验证并记录错误。简单删除所有非数字字符可能将错误输入改成另一笔合法金额。本例没有实施完整业务规则,也没有自动拒绝负数。
严格比较表头能拒绝错误名称、重复列名及顺序变化,但每条数据行仍需另外检查。默认 DictReader 遇到额外字段,会将多出的值放进 None 键对应的列表;缺少字段时通常补 None。本例没有检查这些情况,所以不能当成完整的外部数据验证器。生产导入应明确处理额外字段、缺失值与金额转换失败。
enumerate(reader, start=2)可以给表头后的逻辑记录编号。如果名称中含换行,一个逻辑记录可能占用多条物理文本行。报错时要注明是逻辑记录序号还是物理行位置,不能把两者混作同一个“行号”。
检查重复运行和表格软件打开方式
示例每次先使用 w 重写文件,重新运行后仍只有表头和两条记录。如果你在编辑器中改了 CSV 再直接重跑整个程序,刚改的文件会被生成步骤覆盖;测试错误输入时必须让改动发生在本次生成后、读取前,或将读取与生成拆开。
- 先运行原始程序,确认 lunch, team 保持为一个名称,重新读取时每条记录都有两列。
- 若要测试错误表头,可在写入部分把 fieldnames 中 amount 改为 cost,同时将 writerows 的两条数据键 amount 改为 cost,保持读取部分的预期表头不变。重新运行应报 ValueError: unexpected header;这是读入验证拒绝新表头,而不是 DictWriter 因键不匹配先失败。
- 将这三处恢复为 amount,再次运行并核对合计与记录数,确认没有累计重复行。
CSV 本身不会约束类型,也不会决定表格软件如何解释公式。外部提供、以等号等字符开头的单元格内容,在某些表格程序中可能被当作公式;仅添加 CSV 引号并不保证它作为纯文本处理。共享导出应按接收程序的导入设置与数据规则验证。本例只是 Python 文件处理,没有验证 Excel 的实际导入行为。




