用途:读写、转换和分析 CSV/TSV 文件,自动检测编码与分隔符,支持日文编码场景。
主要能力:读取时可用 python3 scripts/csv_read.py data.csv --info 查看列、类型与行数,--head 10 预览前 10 行,--search "keyword" 搜索行。写入与转换可用 python3 scripts/csv_write.py,支持从 JSON 生成、过滤、排序、选列、重命名、去重、改编码、加 BOM、输出 TSV 等操作,例如 --filter "status==active"、--sort name、--select "name,email"、--dedupe "email"、--encoding cp932、--bom、--tsv;多个 --filter 按 AND 组合。
使用方式:也可直接用 Python csv 模块内联处理,读取用 encoding="utf-8-sig" 或 delimiter="\t",写入时 open() 需带 newline=""。编码选择:现代系统用 utf-8,Excel 兼容用 utf-8-sig 加 --bom,日文旧系统用 cp932。
限制与注意:修改前先用 --info 检查结构;写入新文件路径,不要覆盖源文件;输出乱码时检查并强制编码;含分隔符字段由 csv 模块自动加引号。详细编码说明见 encoding-guide.md。