-excelcsvlisted

# 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） ## 用法 ```js 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' }); ``` ## 自测 ```bash node scripts/exporter.mjs --selftest ```