提高数据处理效率：JavaScript 操作 XLSX 文件的最佳实践

前言

Excel 文件（通常以 .xlsx 为后缀）在各种业务场景中都有广泛应用，如数据分析、财务报告和其他数据表单处理。掌握如何在前端或后端使用 JavaScript 对这些 Excel 文件进行读取、创建和修改，能够显著提升我们的开发效率和数据处理能力。
本文将深入探讨如何使用强大的 xlsx 库来操作 Excel 文件。我们将涵盖如何在 Node.js 和浏览器环境中读取 Excel 文件、创建新的 Excel 文件、修改现有的 Excel 文件以及处理复杂的 Excel 数据结构。

常用操作

读取 Excel 文件

在 Node.js 环境中读取本地文件

在 Node.js 环境中，我们可以轻松地读取本地的 Excel 文件。以下示例展示了如何读取本地的 example.xlsx 文件并将其内容转换为 JSON 格式：

const XLSX = require('xlsx');
const workbook = XLSX.readFile('example.xlsx');// 获取第一个工作表
const sheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[sheetName];// 将工作表转换为 JSON 数据
const data = XLSX.utils.sheet_to_json(worksheet);console.log(data);

在浏览器环境中读取用户上传的文件

在浏览器环境中，处理用户上传的文件是常见需求。以下示例展示了如何结合 HTML 的

<input type="file"> 元素读取用户上传的 Excel 文件：
<input type="file" id="upload" accept=".xlsx" /><script>
document.getElementById('upload').addEventListener('change', handleFile, false);function handleFile(event) {const file = event.target.files[0];const reader = new FileReader();reader.onload = function(e) {const data = new Uint8Array(e.target.result);const workbook = XLSX.read(data, { type: 'array' });const sheetName = workbook.SheetNames[0];const worksheet = workbook.Sheets[sheetName];const jsonData = XLSX.utils.sheet_to_json(worksheet);console.log(jsonData);};reader.readAsArrayBuffer(file);
}
</script>

创建 Excel 文件

创建并下载新的 Excel 文件是另一个常见需求。以下示例展示了如何生成包含示例数据的 Excel 文件，并允许用户下载：

<button id="download">下载 Excel 文件</button><script>
document.getElementById('download').addEventListener('click', function() {// 创建数据const data = [{ "Name": "John", "Age": 30, "City": "New York" },{ "Name": "Peter", "Age": 25, "City": "London" },{ "Name": "Sara", "Age": 22, "City": "Paris" }];// 将数据转换为工作表const worksheet = XLSX.utils.json_to_sheet(data);// 创建工作簿并添加工作表const workbook = XLSX.utils.book_new();XLSX.utils.book_append_sheet(workbook, worksheet, "Sheet1");// 生成 Excel 文件并下载XLSX.writeFile(workbook, 'example.xlsx');
});
</script>

修改 Excel 文件

修改现有的 Excel 文件也是常见的操作需求。以下示例展示了如何读取 Excel 文件、修改某个单元格的值并保存修改后的文件：

const XLSX = require('xlsx');
const workbook = XLSX.readFile('example.xlsx');const sheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[sheetName];// 修改单元格 A1 的值
worksheet['A1'].v = 'Modified Value';// 保存修改后的文件
XLSX.writeFile(workbook, 'modified_example.xlsx');

进阶操作

1. 处理多个工作表

如果 Excel 文件包含多个工作表，我们可以遍历所有工作表并处理每个工作表的数据：

const XLSX = require('xlsx');
const workbook = XLSX.readFile('example.xlsx');// 遍历所有工作表
workbook.SheetNames.forEach(sheetName => {const worksheet = workbook.Sheets[sheetName];const data = XLSX.utils.sheet_to_json(worksheet);console.log(Sheet: ${sheetName}, data);
});

2. 处理复杂的数据结构

处理嵌套的表格或进行数据清洗需要使用 JavaScript 的数组和对象方法：

const XLSX = require('xlsx');
const workbook = XLSX.readFile('complex_example.xlsx');const sheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[sheetName];// 将工作表转换为 JSON 数据
const data = XLSX.utils.sheet_to_json(worksheet);// 清洗数据，去除空值并计算某一列的总和
const cleanedData = data.filter(row => row['Value'] !== null && row['Value'] !== undefined);
const totalValue = cleanedData.reduce((sum, row) => sum + row['Value'], 0);console.log('Cleaned Data:', cleanedData);
console.log('Total Value:', totalValue);

3. 指定单元格格式

const XLSX = require('xlsx');
const data = [{ "Date": new Date(), "Amount": 123.45 }
];const worksheet = XLSX.utils.json_to_sheet(data);
worksheet['A1'].z = 'mm/dd/yyyy'; // 指定日期格式
worksheet['B1'].z = '#,##0.00';  // 指定数字格式const workbook = XLSX.utils.book_new();
XLSX.utils.book_append_sheet(workbook, worksheet, "Sheet1");
XLSX.writeFile(workbook, 'formatted_example.xlsx');

4. 合并单元格

const XLSX = require('xlsx');
const workbook = XLSX.utils.book_new();
const worksheet = XLSX.utils.aoa_to_sheet([['Title1', null, 'Title2'],['Data1', 'Data2', 'Data3']
]);// 合并单元格 A1 和 B1
worksheet['!merges'] = [{ s: { r: 0, c: 0 }, e: { r: 0, c: 1 } } // s 是开始单元格，e 是结束单元格
];XLSX.utils.book_append_sheet(workbook, worksheet, "Sheet1");
XLSX.writeFile(workbook, 'merged_cells_example.xlsx');

5. 设置单元格样式

虽然 xlsx 库本身对样式支持有限，但可以借助 exceljs 库来实现更丰富的样式设置：

const ExcelJS = require('exceljs');
const workbook = new ExcelJS.Workbook();
const worksheet = workbook.addWorksheet('Sheet1');worksheet.columns = [{ header: 'Name', key: 'name' },{ header: 'Age', key: 'age' },{ header: 'City', key: 'city' }
];worksheet.addRow({ name: 'John', age: 30, city: 'New York' });// 设置列宽和单元格样式
worksheet.getColumn('name').width = 20;
worksheet.getRow(1).font = { bold: true };
worksheet.getCell('A2').fill = {type: 'pattern',pattern: 'solid',fgColor: { argb: 'FFFF0000' }
};workbook.xlsx.writeFile('styled_example.xlsx');