node-xlsx是一个轻量级的excel插件，下载导出excel基本的功能这个插件都能实现，本文记录一下express框架中使用node-xlsx插件下载excel表格的步骤。
情况一、读取本地文件并返回前端excel流文件
这种情况适用于下载excel模板场景，毕竟模板是固定的内容，我们在代码的文件夹中存放一个固定的excel模板，读取并返回即可。
- 第一步，肯定是要下载安装这个插件
npm i node-xlsx - 第二步，在对应代码中引入这个插件
const xlsx = require('node-xlsx') - 第三步，就是在对应的路由url中写对应代码，代码如下:
// excel导出下载模板接口
route.get("/exportExcel", (req, res) => {
// 首先，读取本地excel模板文件，并解析成node-xlsx插件需要的数据格式，
// （比如我的表格文件在代码中的excel文件夹下）要引入fs文件模块才能读取哦
const dataByParse = xlsx.parse(fs.readFileSync('./excel/统计模板.xlsx'));
/*
打印出来的数据是一个数组，数组中的每一项（每一个对象）都是一个sheet数据，name属性指定的是每一个sheet的名字
data属性是一个数组，数组中存放的是表格对应每个sheet的数据，data数组中的第一项是“表头”的数据，也可以理解为是
第一行的数据，后面的每一项就是对应每一行“表体”的数据，具体格式，后续也会举例。
*/
console.log("解析数据格式",dataByParse);
// 最后一步，使用xlsx插件自带的build方法将解析后的数据转换成为excel表格（buffer形式的流文件）
// 以流文件的形式返回给前端，前端接收解析下载即可
res.send(xlsx.build(dataByParse))
})
node-xlsx需要的数据格式举例子
比如这样的数据格式，我们看一下数据结构
let excelData = [
// 第一个sheet内容
{
name:"我是sheet1", // 给第一个sheet指名字
data:[ // 注意，这里是一个二维数组
["姓名","年龄","家乡","备注"], // 第一行
["孙悟空","500","花果山","人送外号斗战胜佛"], // 第二行
["猪八戒","88","高老庄","天蓬元帅"], // 第三行
]
},
// 第二个sheet内容
{
name:"我是sheet2", // 给第二个sheet指名字
data:[
["城市","国家","人口","经济水平"], // 同上
["上海","中国","14亿","越来越好"],
["伦敦","英国","7000万","还行"],
["华盛顿","美国","3.4亿","凑活"]
]
}
]
上述数据格式对应效果图
很显然，数据结构和对应导出的excel结果都是对应的
情况二、根据前端传递参数，查询mysql数据并返回前端流文件
这种情况适用于，一次性的表格文件下载。不会占用后端磁盘文件。就是接收前端传递来的参数，然后把参数拼接sql语句。最终把数据结构组装成node-xlsx插件需要的数据格式即可
// excel导出下载模板接口
route.post("/exportExcel", (req, res) => {
// 假设我们mysql数据库查询得到了excelData这个数据结果
let excelData = [
// 第一个sheet内容
{
name: "我是sheet1", // 给第一个sheet指名字
data: [
["姓名", "年龄", "家乡", "备注"], // 第一行
["孙悟空", "500", "花果山", "人送外号斗战胜佛"], // 第二行
["猪八戒", "88", "高老庄", "天蓬元帅"], // 第三行
]
},
// 第二个sheet内容
{
name: "我是sheet2", // 给第二个sheet指名字
data: [
["城市", "国家", "人口", "经济水平"], // 同上
["上海", "中国", "14亿", "越来越好"],
["伦敦", "英国", "7000万", "还行"],
["华盛顿", "美国", "3.4亿", "凑活"]
]
}
]
// excel表格内容配置单元格宽度
let optionArr = {
// 指定sheet1相应宽度
"!cols": [
{ wch: 15 },
{ wch: 15 },
{ wch: 10 },
{ wch: 50 },
],
// 指定sheet2相应宽度
"cols": [
{ wch: 15 },
{ wch: 15 },
{ wch: 10 },
{ wch: 50 },
],
}
// xlsx.build方法第二个参数接收的是单元格的配置参数
res.send(xlsx.build(excelData,optionArr))
})
总结
本文记录的主要是后端方面的代码写法，至于前端的下载excel表格的写法和注意事项常见问题，可以参考我的另外一篇文章，传送门如下：juejin.cn/post/692688…
最后附上npmjs官方网站的文档实例介绍，更加齐全哟： www.npmjs.com/package/nod…
