shuangying0001-beep/tabular-exporter

tabular-exporter —— 记录数组导出为表格

把任意「数组 of 对象」变成带样式的 Excel 或带 BOM 的 CSV。 零依赖：xlsx 由纯 JS 生成（ZIP STORE 法，内置 CRC32），CSV 自带 UTF-8 BOM。无需 npm install 任何包。

适用场景

• 把采集 / 接口返回的结构化数据导出成可交付的 Excel / CSV
• 后台「导出」功能、数据报表、数据迁移
• 需要中文不乱码、带表头样式、冻结首行

提供的函数

函数	说明
exportToExcel(rows, columns, opts?)	生成带样式 xlsx（Buffer），可选落盘 filePath
exportToCsv(rows, columns, opts?)	生成带 BOM 的 CSV 字符串
exportTable(rows, columns, opts?)	统一入口，opts.format = 'xlsx' | 'csv'
columnsFromKeys(keys, widths?)	由 key 列表快速生成列配置

columns 形如 [{ key, header?, width? }]，rows 为对象数组。

样式特性：

• 表头：加粗 + 白字 + 蓝底（4472C4）
• 冻结首行
• 斑马纹（偶数行浅灰底）
• 布尔值 → 是/否；数组 → 换行；对象 → JSON
• xlsx 与 Excel / WPS / LibreOffice 兼容（标准 OOXML）

用法

import { exportTable, columnsFromKeys } from './scripts/exporter.mjs';

const rows = [
  { title: '无线鼠标', price: 99.5, inStock: true },
  { title: '机械键盘', price: 299, inStock: false },
];
const columns = [
  { key: 'title', header: '标题', width: 40 },
  { key: 'price', header: '价格', width: 12 },
  { key: 'inStock', header: '有货', width: 8 },
];

// 导出 xlsx（直接落盘）
exportTable(rows, columns, { format: 'xlsx', filePath: 'out.xlsx', sheetName: '商品' });

// 导出 csv（返回字符串）
const csv = exportTable(rows, columns, { format: 'csv' });

自测

node scripts/exporter.mjs --selftest