# csv-quality-checker

**Repository Path**: aa361604324/csv-quality-checker

## Basic Information

- **Project Name**: csv-quality-checker
- **Description**: CSV表格质量检查和问题报告工具示例
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# csv-quality-checker

CSV 表格质量检查小工具示例。

适合场景：

- 客户名单、订单表、报名表需要检查漏填
- 需要找出重复手机号、邮箱、编号
- 邮箱、日期字段格式比较乱
- 清洗前先输出一份问题清单，方便客户确认

## 示例

输入：`examples/customers.csv`

```csv
id,name,email,phone,signup_date
1001,张三,zhangsan@example.com,13800000001,2026-06-01
1002,李四,lisi@example,13800000002,2026/06/02
1002,,wangwu@example.com,13800000002,2026-06-03
```

运行：

```bash
python3 scripts/check_csv.py examples/customers.csv outputs/issues.csv --required id,name,email --unique id,phone --email email --date signup_date
```

输出：`outputs/issues.csv`

## 支持检查

- 必填字段为空
- 指定字段重复
- 邮箱格式异常
- 日期格式异常，默认要求 `YYYY-MM-DD`

## 验证

```bash
bash run_checks.sh
```

## 客户需要提供

- 原始 CSV 或 Excel 转出的 CSV
- 哪些字段必填
- 哪些字段不能重复
- 邮箱、日期、手机号等字段名
- 需要最终清洗，还是只要问题报告

## 交付内容

- 问题清单
- 清洗建议
- 可复用检查脚本
- 如需要，可继续输出清洗后的表格