用 Codex 做商品 CSV 检查工具，附源码与样例

想用 Codex 做一个用得上的小工具，可以从规则明确的数据检查开始。这次的任务是读取商品 CSV，把漏填、错误数值和重复编号列出来，生成浏览器能打开的报告。

先让人看清问题，再决定怎样处理原表。

把业务规则写在前面

这个教学例子约定：编号、品名、长宽高和重量必填；尺寸单位固定为 cm，重量固定为 g；数值必须大于0。编号重复时，两行都标记，留给人确认。

这里的“重量不能为0”是本例规则，不是所有字段都适用。库存为0就可能完全合法，不能让模型替你决定业务含义。

任务模板：

读取约定字段的 UTF-8 CSV，按上述规则检查。
输出 CSV 行号、字段、原值和原因，生成 HTML 核对报告。
原表只读，不猜缺失值，不自动删除重复项。
覆盖正常、漏填、错误数值和重复编号的模拟样本。
输出目录已存在时停止，不覆盖旧文件。
给出运行命令、报告位置和未覆盖范围。

Python 标准库的 csv 模块可以处理字段分隔与引号。不要直接用逗号切字符串，否则带逗号的品名就容易被切坏。Python csv 文档

运行后核对什么

在示例项目目录执行，output 必须是尚不存在的新目录：

python -X utf8 check_products.py sample.csv --output output

原运行的6条模拟商品中，4条需要核对，共5处问题：高度漏填、重量为0、宽度写成“待确认”，以及两行重复编号。报告应能回到每一个原始行，而不是只给一个“存在错误”的总数。

2026年10月11日，Windows / Python 3.13.5 的6项测试通过，包含输入不变、既有输出保护和 HTML 转义；报告在本地 Edge 查看。脚本运行期间不调用模型或外部网络。

这份工具检查不到什么

格式通过不代表数据真实。它没有核验真实业务表，也不自动判断单位混用、报价或规格是否合理。适配新表前，先把字段、单位和有效范围改成你自己的规则，再用小样本验收。

下载教学项目、模拟CSV与测试

原笔记发表于2026年10月11日，博客于10月27日整理，沿用原验收记录；下载包仅含教学源码、样例和说明。

本文发表日期： 2026-10-11