· 全部指南
CSV 与 JSON 互转场景
CSV 主导表格导出、遗留 ETL 与低代码导入向导；JSON 主导 REST API、NoSQL 文档与配置快照。对接 Shopify 导出与 Node 服务、把 GA4 报表载入数仓、或让只接受对象数组的后端喂给 React 表格时，二者互转是日常任务。
csv-to-json 与 json-to-csv 在浏览器内处理中小文件，适合快速验证列映射与原型脚本。文件超过数百 MB 时浏览器内存成为瓶颈；生产规模应改用流式 CLI（csvkit、mlr、谨慎使用 jq）。
典型场景：市场部门发来 5 万条线索的 UTF-8 CSV，上传 API 需要 JSON。流程：打开 csv-to-json 确认表头映射 → 检查前十个对象的类型问题（邮编被当数字丢前导零）→ 为嵌套源数据调整 flatten 规则 → 导出 JSON 打 staging 端点。常见错误：默认首行必是表头；忽略欧洲 Excel 常用的 ; 分隔符；让 Excel 把长数字 ID 自动成科学计数法再导出。
编码与分隔符
CSV 方言比 RFC 4180 丰富得多。分隔符可能是逗号、分号或 Tab；含分隔符的字段须引号包裹，字段内引号双写（""）。换行可能是 CRLF 或 LF。带 BOM 的 UTF-8 会在首列名前缀不可见字节——肉眼是 "id"，JSON schema 却校验 \ufeffid 失败。
用 text-analyzer 或 hex-encoder 检查可疑表头单元。json-to-csv 时嵌套对象须明确 flatten 策略：user.name 与 user_name 会影响下游导入。JSON 数组要么展开为多行、要么整列字符串化——文档化流水线采用哪一种。
实例：tags 数组 ["ops","urgent"] 可变成其它列重复的两行，或单格 ops;urgent。选定一种约定，先用手工五行验证再处理百万级。转换后核对行数：除非展开规则故意倍增，CSV 数据行应与 JSON 数组长度一致。
清洗与去重
唯一约束会让重复导入大声失败——更糟的是安静成功并污染分析。csv-dedupe 按选定键列去重后再载入 staging。流程：按 email 去重 → 核对剩余条数 → csv-to-json → 通过幂等 upsert API 写入。
空行、地址字段内引号换行、转义不一致会导致解析报错却只提示「第 1847 行」。csv-to-json 报列错位时可用十六进制视图查原始文件；常见元凶是多余 \r 或未转义 "。转换后可配合 json-formatter 美化样例对象供 code review。
隐私
表格是 PII 磁石：邮箱、手机、工号、薪资档。上传到陌生「免费转换站」即使厂商承诺删除也可能构成合规事件。Towalles 本地转换意味着处理过程不上传服务器——但剪贴板历史、云同步文件夹与屏幕共享仍会外泄。
向承包商分享 JSON 导出前，用 pii-scanner 扫描字符串字段，捕捉误含的 ssn、信用卡或 API 密钥模式。非生产环境应脱敏或哈希标识。团队规范：演示用合成数据集；生产导出走审计流水线；匆忙排障时若把真实客户文件贴进任何工具标签页，须立即轮换相关凭据。