ExcelJS完整指南：如何在JavaScript中高效处理Excel文件-CSDN博客

ExcelJS完整指南：如何在JavaScript中高效处理Excel文件

【免费下载链接】exceljs Excel Workbook Manager 项目地址: https://gitcode.com/gh_mirrors/ex/exceljs

ExcelJS是一个功能强大的JavaScript库，专门用于读取、操作和写入Excel电子表格数据，支持XLSX和JSON格式。这个开源项目为开发者提供了简单而强大的接口来处理电子表格数据，无论是简单的数据导出还是复杂的报表生成都能轻松应对。

为什么选择ExcelJS？🚀

在当今数据驱动的时代，Excel文件处理是几乎所有企业应用都需要的功能。传统的解决方案往往复杂且性能低下，而ExcelJS通过其优雅的API设计和高性能处理能力，成为了Node.js和浏览器环境中处理Excel文件的终极解决方案。

ExcelJS的核心优势：

跨平台支持：Node.js和浏览器环境
完整功能：支持样式、公式、图表、图片等
高性能：流式处理支持大文件操作
简单易用：直观的API设计

快速上手：5分钟创建你的第一个Excel文件

安装ExcelJS非常简单：

npm install exceljs

让我们从一个简单的示例开始，创建一个包含员工数据的Excel文件：

const ExcelJS = require('exceljs');

// 创建工作簿
const workbook = new ExcelJS.Workbook();
workbook.creator = '系统管理员';
workbook.created = new Date();

// 添加工作表
const worksheet = workbook.addWorksheet('员工数据');

// 设置列宽和标题
worksheet.columns = [
  { header: '员工ID', key: 'id', width: 10 },
  { header: '姓名', key: 'name', width: 20 },
  { header: '部门', key: 'department', width: 15 },
  { header: '薪资', key: 'salary', width: 12 }
];

// 添加数据行
worksheet.addRow({ id: 1, name: '张三', department: '技术部', salary: 15000 });
worksheet.addRow({ id: 2, name: '李四', department: '市场部', salary: 12000 });
worksheet.addRow({ id: 3, name: '王五', department: '财务部', salary: 13000 });

// 设置标题样式
worksheet.getRow(1).font = { 
  bold: true, 
  color: { argb: 'FFFFFFFF' } 
};
worksheet.getRow(1).fill = {
  type: 'pattern',
  pattern: 'solid',
  fgColor: { argb: 'FF4F81BD' }
};

// 保存文件
await workbook.xlsx.writeFile('员工数据.xlsx');
console.log('Excel文件已成功生成！');

核心功能深度解析

1. 高级样式控制

ExcelJS提供了全面的样式控制能力，让你的报表更加专业：

// 设置单元格样式
const cell = worksheet.getCell('B2');
cell.value = '重要数据';
cell.font = {
  name: '微软雅黑',
  size: 14,
  bold: true,
  color: { argb: 'FFFF0000' },
  italic: true
};

cell.border = {
  top: { style: 'medium', color: { argb: 'FF000000' } },
  left: { style: 'medium', color: { argb: 'FF000000' } },
  bottom: { style: 'medium', color: { argb: 'FF000000' } },
  right: { style: 'medium', color: { argb: 'FF000000' } }
};

cell.fill = {
  type: 'gradient',
  gradient: 'angle',
  degree: 0,
  stops: [
    { position: 0, color: { argb: 'FFFF0000' } },
    { position: 1, color: { argb: 'FF00FF00' } }
  ]
};

// 数字格式
worksheet.getColumn('D').numFmt = '¥#,##0.00';

2. 数据验证与公式

确保数据质量并实现计算功能：

// 数据验证
worksheet.dataValidation.add('B2:B100', {
  type: 'list',
  allowBlank: true,
  formulae: ['"技术部,市场部,财务部,人事部"'],
  showErrorMessage: true,
  errorTitle: '无效输入',
  error: '请从下拉列表中选择部门'
});

// 添加公式
worksheet.getCell('E2').value = { 
  formula: 'SUM(D2:D100)',
  result: 0
};

// 条件格式
worksheet.addConditionalFormatting({
  ref: 'D2:D100',
  rules: [
    {
      type: 'cellIs',
      operator: 'greaterThan',
      formulae: [10000],
      style: { fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFFFC7CE' } } }
    }
  ]
});

实际应用场景

场景1：数据报表导出

async function exportSalesReport(salesData) {
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('销售报表');
  
  // 设置报表标题
  worksheet.mergeCells('A1:F1');
  const titleCell = worksheet.getCell('A1');
  titleCell.value = '2024年季度销售报表';
  titleCell.font = { size: 18, bold: true, color: { argb: 'FF2E75B6' } };
  titleCell.alignment = { horizontal: 'center', vertical: 'middle' };
  
  // 添加表头
  const headers = ['季度', '产品A', '产品B', '产品C', '产品D', '总计'];
  worksheet.addRow(headers);
  
  // 填充数据
  salesData.forEach(item => {
    worksheet.addRow([
      item.quarter,
      item.productA,
      item.productB,
      item.productC,
      item.productD,
      { formula: `SUM(B${worksheet.rowCount}:E${worksheet.rowCount})` }
    ]);
  });
  
  // 添加总计行
  const totalRow = worksheet.rowCount + 1;
  worksheet.addRow([
    '总计',
    { formula: `SUM(B3:B${worksheet.rowCount - 1})` },
    { formula: `SUM(C3:C${worksheet.rowCount - 1})` },
    { formula: `SUM(D3:D${worksheet.rowCount - 1})` },
    { formula: `SUM(E3:E${worksheet.rowCount - 1})` },
    { formula: `SUM(F3:F${worksheet.rowCount - 1})` }
  ]);
  
  // 设置总计行样式
  const lastRow = worksheet.getRow(worksheet.rowCount);
  lastRow.font = { bold: true };
  lastRow.fill = {
    type: 'pattern',
    pattern: 'solid',
    fgColor: { argb: 'FFF2F2F2' }
  };
  
  return await workbook.xlsx.writeBuffer();
}

场景2：流式处理大型文件

对于大数据量场景，ExcelJS提供了流式处理API：

const ExcelJS = require('exceljs');

async function processLargeDataset(dataStream) {
  const workbook = new ExcelJS.stream.xlsx.WorkbookWriter({
    filename: '大型数据集.xlsx',
    useStyles: true,
    useSharedStrings: true
  });
  
  const worksheet = workbook.addWorksheet('数据');
  
  // 添加表头
  worksheet.columns = [
    { header: 'ID', width: 10 },
    { header: '名称', width: 30 },
    { header: '数值', width: 15 }
  ];
  
  // 流式写入数据
  for await (const data of dataStream) {
    const row = worksheet.addRow([
      data.id,
      data.name,
      data.value
    ]);
    
    // 提交行以释放内存
    row.commit();
    
    // 每1000行刷新一次
    if (row.number % 1000 === 0) {
      await new Promise(resolve => setImmediate(resolve));
    }
  }
  
  // 完成写入
  await workbook.commit();
  console.log('大型文件处理完成！');
}

性能优化技巧

1. 内存管理

// 批量处理数据，避免内存溢出
function processDataInBatches(data, batchSize = 1000) {
  const workbook = new ExcelJS.Workbook();
  const worksheet = workbook.addWorksheet('数据');
  
  for (let i = 0; i < data.length; i += batchSize) {
    const batch = data.slice(i, i + batchSize);
    worksheet.addRows(batch);
    
    // 定期清理内存
    if (i % 5000 === 0) {
      global.gc && global.gc();
    }
  }
  
  return workbook;
}

2. 样式复用

// 创建样式模板
const styles = {
  header: {
    font: { bold: true, size: 12, color: { argb: 'FFFFFFFF' } },
    fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4F81BD' } },
    alignment: { horizontal: 'center' }
  },
  highlight: {
    fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFFFFF00' } }
  },
  number: {
    numFmt: '#,##0.00'
  }
};

// 应用样式
worksheet.getRow(1).font = styles.header.font;
worksheet.getRow(1).fill = styles.header.fill;
worksheet.getColumn('C').numFmt = styles.number.numFmt;

生态系统集成

与Express.js集成

const express = require('express');
const ExcelJS = require('exceljs');
const app = express();

app.get('/export/report', async (req, res) => {
  try {
    const workbook = new ExcelJS.Workbook();
    const worksheet = workbook.addWorksheet('报表数据');
    
    // 生成报表数据
    worksheet.columns = [
      { header: '日期', key: 'date', width: 15 },
      { header: '销售额', key: 'sales', width: 15 },
      { header: '利润', key: 'profit', width: 15 }
    ];
    
    // 模拟数据
    const reportData = generateReportData();
    worksheet.addRows(reportData);
    
    // 设置响应头
    res.setHeader('Content-Type', 
      'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
    res.setHeader('Content-Disposition', 
      'attachment; filename=report.xlsx');
    
    // 直接写入响应流
    await workbook.xlsx.write(res);
    res.end();
  } catch (error) {
    console.error('导出失败:', error);
    res.status(500).send('导出失败');
  }
});

前端浏览器使用

<!DOCTYPE html>
<html>
<head>
  <script src="https://cdn.jsdelivr.net/npm/exceljs@4.4.0/dist/exceljs.min.js"></script>
</head>
<body>
  <button onclick="exportToExcel()">导出Excel</button>
  
  <script>
  async function exportToExcel() {
    const workbook = new ExcelJS.Workbook();
    const worksheet = workbook.addWorksheet('浏览器数据');
    
    worksheet.addRow(['浏览器', '版本', '市场份额']);
    worksheet.addRow(['Chrome', '90+', '65%']);
    worksheet.addRow(['Firefox', '88+', '10%']);
    worksheet.addRow(['Safari', '14+', '15%']);
    
    const buffer = await workbook.xlsx.writeBuffer();
    
    // 创建下载链接
    const blob = new Blob([buffer], {
      type: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
    });
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = '浏览器数据.xlsx';
    a.click();
    URL.revokeObjectURL(url);
  }
  </script>
</body>
</html>

最佳实践总结

1. 错误处理

async function safeExcelOperation() {
  try {
    const workbook = new ExcelJS.Workbook();
    await workbook.xlsx.readFile('data.xlsx');
    
    // 处理逻辑
    const worksheet = workbook.getWorksheet(1);
    if (!worksheet) {
      throw new Error('工作表不存在');
    }
    
    // 数据处理
    return processWorksheet(worksheet);
  } catch (error) {
    console.error('Excel操作失败:', {
      message: error.message,
      stack: error.stack
    });
    throw new Error(`Excel处理失败: ${error.message}`);
  }
}

2. 模块化设计

建议将Excel操作封装为独立的服务模块：

// excel-service.js
class ExcelService {
  constructor() {
    this.ExcelJS = require('exceljs');
  }
  
  async createReport(data, options = {}) {
    const workbook = new this.ExcelJS.Workbook();
    const worksheet = workbook.addWorksheet(options.sheetName || 'Sheet1');
    
    // 应用模板
    if (options.template) {
      this.applyTemplate(worksheet, options.template);
    }
    
    // 填充数据
    this.fillData(worksheet, data);
    
    // 应用样式
    if (options.styles) {
      this.applyStyles(worksheet, options.styles);
    }
    
    return workbook;
  }
  
  async exportToFile(workbook, filepath) {
    return workbook.xlsx.writeFile(filepath);
  }
  
  async exportToBuffer(workbook) {
    return workbook.xlsx.writeBuffer();
  }
}

核心源码结构

ExcelJS的源码组织非常清晰，主要分为以下几个模块：

文档模型：lib/doc/ - 包含Workbook、Worksheet、Cell等核心类
XLSX处理：lib/xlsx/ - XLSX文件格式的读写实现
CSV处理：lib/csv/ - CSV文件的读写支持
流式处理：lib/stream/ - 大文件流式处理支持
工具函数：lib/utils/ - 各种工具类和辅助函数

结语

ExcelJS作为一款功能全面的Excel处理库，为JavaScript开发者提供了强大的电子表格操作能力。无论是简单的数据导出，还是复杂的报表生成，ExcelJS都能提供优雅的解决方案。其跨平台特性和高性能设计使其成为企业级应用中的理想选择。

通过本文的介绍，你应该已经掌握了ExcelJS的核心功能和最佳实践。现在就开始使用ExcelJS，让你的数据处理工作变得更加高效和简单吧！

记住： 在处理大型文件时，始终优先考虑使用流式API；在样式设计时，尽量复用样式对象以提高性能；在生产环境中，务必添加完善的错误处理机制。

【免费下载链接】exceljs Excel Workbook Manager 项目地址: https://gitcode.com/gh_mirrors/ex/exceljs

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考