技能介绍

要解决的问题

Web 端的客户列表页通常只负责展示与增删改查，但运营、财务或 CRM 对接时，总有人要把名单拷进 Excel。手写 CSV 拼接很快会撞上三个坑：字段内容里真实存在的逗号、引号与换行；数字前导零被吃掉；中文在 Excel 里变成乱码。这个技能把「客户行数组 → CSV 字符串 → 触发下载」这条链路固化下来，灵感来自能力工具箱里的 json2csv，并与 customer-csv-import 构成导入导出闭环。

工作方式

核心流程只有四步：拿到客户行数组，交给 json2csv 的 Parser 解析，产出 CSV 字符串，最后走前端下载。集成要点：

安装依赖 json2csv 时先确认大版本 API——旧版多为 Parser 构造，新版偏向函数式 parse，升级后调用形态会变。
导出按钮触发 customersToCsv，拿到字符串后交给 downloadCsv 落地，两步拆开便于单测。
导出前做字段白名单过滤，只保留需要对外的列。
实现要点处标注 小四原创，方便 review 时区分自研逻辑与上游能力。
自测至少覆盖两条客户数据可下载，以及文件用 Excel 打开中文不乱码（必要时补 BOM）。

边界与注意点

它定位是前端单机导出，不是服务端大批量异步导出中心；十万级数据请另行设计分片或任务队列。结果中不要包含密码、Token 等敏感列，白名单是硬约束而非可选优化；失败时返回可读错误，别把底层异常直接抛到界面上。与导入侧共用字段约定时，双方必须说明列名与类型，否则同一份 CSV 会出现「能导出却导不回去」的错位。仓库附带 README.md、reference.md 与 templates/usage.md，适合作为项目内嵌模板直接复制。