记录数据一键导出 Excel/CSV(带样式)
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3ff3c268/tabular-exporter。
技能介绍
要解决什么问题
后台「导出」、报表交付或数据迁移时,常见输入是接口或采集得到的对象数组,却要落成业务能直接打开的 Excel 或 CSV。手写 OOXML、处理 UTF-8 BOM 防乱码、再补表头样式和冻结首行,既费时间又容易在依赖链上踩坑。
技能如何工作
tabular-exporter 把「数组 of 对象」映射为列配置 columns(key、header、width)与行数据 rows,通过统一入口 exportTable 或分别调用 exportToExcel / exportToCsv 输出:
- Excel:纯 JS 生成标准 xlsx(ZIP STORE + 内置 CRC32),表头加粗白字蓝底(
4472C4)、冻结首行、偶数行斑马纹;布尔值渲染为「是/否」,数组换行、对象转 JSON 字符串 - CSV:带 UTF-8 BOM 的字符串,便于 Excel / WPS 正确识别中文
- 列配置:
columnsFromKeys可由字段 key 列表快速生成列定义
可选 filePath 将 xlsx Buffer 落盘;格式与 Excel、WPS、LibreOffice 等 OOXML 实现兼容。
适用边界
面向结构化、列明确的表格导出,不是通用电子表格引擎:复杂公式、图表、多 Sheet 编排需另选方案。列类型转换规则固定(布尔/数组/对象如上),自定义展示逻辑要在写入前自行预处理 rows。
使用场景
- 管理后台把接口返回的用户或订单对象数组生成带表头样式、冻结首行的 xlsx 供业务下载
- 采集或爬虫落库后的结构化记录批量导出为带 UTF-8 BOM 的 CSV,避免 Excel 打开中文乱码
- 数据迁移前将内存中的 JSON 行集按字段 key 快速配列并输出标准 OOXML,交给 Excel/WPS 验收
- 报表页一键导出:布尔、嵌套数组与对象在单元格内按固定规则(是/否、换行、JSON)呈现
适合人员
- 负责 Node/后端「导出」接口、输入已是对象数组且不想引入 xlsx npm 包的工程师
- 要把接口或脚本输出的结构化数据交付给非技术同事、必须带表头样式与中文不乱码的全栈开发
- 做数据迁移或对账、需将中间态记录批量落成 Excel/CSV 再人工核对的数据运营
- 在 Skill/脚本环境里封装表格导出、希望用 `exportTable` 统一切换 xlsx 与 csv 的集成开发者