在后端开发的实际业务中，经常需要处理不同格式数据的转换需求，其中将XML数据输出为Excel文件是较为常见的场景，比如将业务系统导出的XML格式报表转换为更易查看的Excel文件。本文将以Node.js环境为例，介绍完整的实现方案。
实现思路梳理
整个转换流程主要分为三个核心步骤：首先读取并解析XML格式的原始数据，提取出需要写入Excel的结构化内容；然后创建Excel工作簿，根据解析后的数据生成对应的工作表；最后将生成的Excel文件输出，支持直接下载或者保存到服务器指定路径。
所需依赖安装
实现该功能需要两个核心依赖库，分别是用于解析XML的xml2js和用于生成Excel文件的exceljs，通过npm命令安装即可：
npm install xml2js exceljs
XML数据解析
假设我们有如下格式的XML数据，包含用户的基本信息：
<users>
<user>
<id>1</id>
<name>张三</name>
<age>25</age>
<email>zhangsan@ipipp.com</email>
</user>
<user>
<id>2</id>
<name>李四</name>
<age>28</age>
<email>lisi@ipipp.com</email>
</user>
</users>
使用xml2js解析该XML数据的代码如下：
const xml2js = require('xml2js');
const parser = new xml2js.Parser({ explicitArray: false });
// XML字符串内容
const xmlData = `<users>
<user>
<id>1</id>
<name>张三</name>
<age>25</age>
<email>zhangsan@ipipp.com</email>
</user>
<user>
<id>2</id>
<name>李四</name>
<age>28</age>
<email>lisi@ipipp.com</email>
</user>
</users>`;
// 解析XML数据
parser.parseString(xmlData, (err, result) => {
if (err) {
console.error('XML解析失败:', err);
return;
}
// 提取用户列表，处理单用户的情况
const userList = Array.isArray(result.users.user) ? result.users.user : [result.users.user];
console.log('解析后的用户数据:', userList);
});
生成Excel文件
解析得到结构化数据后，使用exceljs创建Excel工作簿并写入数据，代码如下：
const ExcelJS = require('exceljs');
// 创建Excel工作簿
const workbook = new ExcelJS.Workbook();
// 添加工作表，命名为用户数据
const worksheet = workbook.addWorksheet('用户数据');
// 设置工作表列头
worksheet.columns = [
{ header: '用户ID', key: 'id', width: 10 },
{ header: '姓名', key: 'name', width: 15 },
{ header: '年龄', key: 'age', width: 10 },
{ header: '邮箱', key: 'email', width: 25 }
];
// 将解析后的用户数据写入工作表
userList.forEach(user => {
worksheet.addRow({
id: user.id,
name: user.name,
age: user.age,
email: user.email
});
});
// 设置表头样式
worksheet.getRow(1).font = { bold: true };
worksheet.getRow(1).alignment = { horizontal: 'center' };
完整实现与文件输出
将XML解析和Excel生成的逻辑整合，同时实现文件保存到本地和接口返回下载的功能，完整代码如下：
const xml2js = require('xml2js');
const ExcelJS = require('exceljs');
const fs = require('fs');
const path = require('path');
// XML数据
const xmlData = `<users>
<user>
<id>1</id>
<name>张三</name>
<age>25</age>
<email>zhangsan@ipipp.com</email>
</user>
<user>
<id>2</id>
<name>李四</name>
<age>28</age>
<email>lisi@ipipp.com</email>
</user>
</users>`;
// 主函数
async function xmlToExcel() {
try {
// 1. 解析XML数据
const parser = new xml2js.Parser({ explicitArray: false });
const result = await parser.parseStringPromise(xmlData);
const userList = Array.isArray(result.users.user) ? result.users.user : [result.users.user];
// 2. 创建Excel工作簿
const workbook = new ExcelJS.Workbook();
const worksheet = workbook.addWorksheet('用户数据');
// 设置列头
worksheet.columns = [
{ header: '用户ID', key: 'id', width: 10 },
{ header: '姓名', key: 'name', width: 15 },
{ header: '年龄', key: 'age', width: 10 },
{ header: '邮箱', key: 'email', width: 25 }
];
// 写入数据
userList.forEach(user => {
worksheet.addRow({
id: user.id,
name: user.name,
age: user.age,
email: user.email
});
});
// 设置表头样式
worksheet.getRow(1).font = { bold: true };
worksheet.getRow(1).alignment = { horizontal: 'center' };
// 3. 保存文件到本地
const outputPath = path.join(__dirname, 'user_data.xlsx');
await workbook.xlsx.writeFile(outputPath);
console.log('Excel文件已保存到:', outputPath);
// 如果是接口场景，返回文件流
// return workbook.xlsx.write(res);
} catch (err) {
console.error('转换过程出错:', err);
}
}
// 执行函数
xmlToExcel();
注意事项
- 解析XML时需要注意单节点和多节点的差异，避免出现数组操作错误，上述代码通过判断
Array.isArray做了兼容处理。 - 生成Excel时可以根据需求设置单元格样式、合并单元格、添加公式等，
exceljs提供了丰富的配置选项。 - 如果XML数据来自外部请求，需要做好异常处理，避免恶意XML内容导致解析异常。