跳到正文
CSV Guard

CSV 约定检查器

合作方的文件又坏了。准确找出是哪一列、哪几行。

写下你期望的列,放入合作方发来的 CSV,CSV Guard 会检查每个表头和每一行。改名和缺失的列、错误日期、重复值、损坏的数字和有风险的单元格都会带着行号列出,另附一份可以直接回复对方的证据说明。

查看规则格式
  • 列名被改
  • 日期格式错误
  • ID 重复
示例表格。订单和邮箱均为虚构。

这是什么

一个免费的检查工具,把 CSV 文件和双方约定的格式逐项比对。能正确处理引号、值内逗号、分号、制表符和 Excel 导出,全程在浏览器中运行。

适合谁

导入合作方数据的运营团队、数据工程师、守着脆弱导入流程的创始人,以及夹在两家供应商之间的客服团队。

解决什么问题

导入要么报出含糊的错误,要么更糟,悄悄写入错误数据。这里每个问题都有对应的列、行和示例,修复从事实开始,而不是来回扯皮。

检查文件

文件只在当前标签页中读取,不会上传或保存。

每行写一列,后跟类型和可选标记;也可以直接粘贴期望的表头行。
粘贴内容或打开文件。逗号、分号、制表符和竖线会自动识别。

还没有检查

粘贴规则和 CSV,或载入示例查看完整报告。

证据说明包含文件中的示例值。发到团队之外前请先检查。

规则格式

约定写一次,每次交付都能复用。

order_id int required unique
email email required
amount decimal required
currency enum:EUR|USD|TRY
created_at date required
sku text
  1. 先写列名

    按约定原样写出列名。匹配时也会识别大小写、空格和小的拼写差异,并告诉你属于哪一种。

  2. 再写类型

    text、int、decimal、date、email、url、bool,或 enum: 后接用竖线分隔的允许值。

  3. 最后写标记

    required 表示不能有空单元格,unique 表示不能有重复值。不需要就不写。

  4. 或者只写表头

    粘贴期望的表头行,每一列只检查是否存在和顺序。

使用方法

  1. 定义约定

    列出期望的列及其类型和标记,和导入代码放在一起保存。

  2. 放入文件

    粘贴 CSV 或打开文件。分隔符、引号和换行会自动识别。

  3. 阅读问题

    错误会让导入失败或写入错误数据。警告值得清理,但不会阻止你。

  4. 发送证据

    把证据说明复制到与合作方的对话中,或下载问题 CSV 给团队。

注意事项

  • 日期默认应为 ISO 格式。日在前或月在前的格式容易混淆,会被标出。
  • 20 MB 以内的文件在大多数浏览器中运行流畅。更大的文件请拆分。
  • Excel 文件需要先另存为 CSV。
  • 类型按每个值逐一检查。即使某个值在人看来很奇怪,整列仍可能通过。

常见问题

文件会上传到哪里吗?

不会。解析和检查都在本页完成,文件不会离开你的设备。

为什么公式单元格算错误?

以 = 或 @ 开头的单元格,在表格软件中打开时可能作为公式执行。这是已知的攻击方式,称为 CSV 注入。

什么是字节顺序标记?

一些工具在 UTF 8 文件开头加上的不可见字符。它可能粘在第一个表头名上,导致匹配失败。

能帮我直接修好文件吗?

它会准确告诉你在哪里改什么。自动改写合作方的数据只会掩盖问题,而不是解决问题。

联系开发者

有问题、想法或工作机会?欢迎通过 X 或 Telegram 联系。

支持开发者

如果这个工具帮你节省了时间,可以用自己的钱包向这个 EVM 地址打赏。

0xd28Fd90eD69092bd01598f237aad33a0cc9c3EeA