type ColumnItem = { prop?: string label?: string formatter?: (row: any, column: any, cellValue: any, index: number) => any } type ExportOptions = { rows: any[] columns: ColumnItem[] fileName?: string transformCell?: (prop: string, value: any, row: any) => any } function normalizeCell(value: any) { if (value === undefined || value === null) return '' if (Array.isArray(value)) return value.join(', ') if (typeof value === 'object') return JSON.stringify(value) return value } export async function exportUpperTableRows(options: ExportOptions) { // xlsx 体积较大(约 850KB),只在真正导出时加载,避免进入首屏依赖图 const XLSX = await import('xlsx') const { rows, columns, fileName = `export-${Date.now()}.xlsx`, transformCell } = options const exportColumns = (columns || []).filter((column) => !!column.prop) const exportData = (rows || []).map((row, index) => { const mapped: Record = {} exportColumns.forEach((column) => { const prop = String(column.prop) const label = column.label || prop const rawValue = row[prop] const formattedValue = column.formatter ? column.formatter(row, { property: prop }, rawValue, index) : rawValue const finalValue = transformCell ? transformCell(prop, formattedValue, row) : formattedValue mapped[label] = normalizeCell(finalValue) }) return mapped }) const ws = XLSX.utils.json_to_sheet(exportData) const wb = XLSX.utils.book_new() XLSX.utils.book_append_sheet(wb, ws, '数据导出') XLSX.writeFile(wb, fileName) }