javascript 如何将 json 格式数组转为 excel 表格

在处理数据时，经常需要将JSON格式数组转换为Excel表格，主要是为了提高数据可读性、方便数据分析和报表制作。JavaScript中可以通过几个步骤实现这一转换：首先是准备JSON数据、然后使用第三方库如xlsx或SheetJS来创建工作簿和工作表、接着是将JSON数据写入工作表、最后是导出Excel文件。在这些步骤中，使用xlsx库尤其值得详细讨论，因为它提供了一种简便的方法来处理Excel文件的读写操作。

一、准备JSON数据

在开始转换之前，首先你需要有一个JSON格式的数组。这通常来源于前端表单的输入、API请求的响应或是其他数据源。JSON格式的数据易于处理和传输，是Web开发中常用的数据格式。

const jsonData = [
  { 名字: "张三", 年龄: 28, 工作: "软件工程师" },
  { 名字: "李四", 年龄: 25, 工作: "产品经理" },
  // 更多数据...
];

二、使用`XLSX`库创建工作簿和工作表

XLSX库是一个非常流行的JavaScript库，用于处理Office的Excel文件。首先，你需要通过npm或yarn将其添加到你的项目中。

npm install xlsx 或者 yarn add xlsx

然后，可以使用XLSX库将JSON数据写入Excel工作表：

const XLSX = require('xlsx');
// 创建一个新的工作簿
const workbook = XLSX.utils.book_new();
// 将JSON数组转换成工作表
const worksheet = XLSX.utils.json_to_sheet(jsonData);
// 向工作簿添加工作表
XLSX.utils.book_append_sheet(workbook, worksheet, 'Sheet1');

三、导出Excel文件

转换后，接下来就是将包含数据的工作簿导出为Excel文件。XLSX库支持多种格式的导出，但通常我们使用.xlsx作为Excel文件的扩展名。

// 导出Excel文件
XLSX.writeFile(workbook, 'output.xlsx');

这段代码会在你的项目根目录（或你指定的路径）生成一个名为output.xlsx的文件，里面包含了由JSON数据转换来的表格数据。

四、客户端下载Excel文件

在Web应用中，你可能需要让用户能够通过点击按钮来下载生成的Excel文件。这可以通过创建一个Blob对象，并利用HTML的<a>标签来实现：

function downloadExcel(jsonData) {
  const worksheet = XLSX.utils.json_to_sheet(jsonData);
  const workbook = XLSX.utils.book_new();
  XLSX.utils.book_append_sheet(workbook, worksheet, 'Sheet1');
  // 使用`XLSX.write`创建Blob对象
  const blob = new Blob([s2ab(XLSX.write(workbook, {bookType:'xlsx', type:'binary'}))], {
    type: "application/octet-stream"
  });
  // 创建一个隐藏的<a>标签并模拟点击进行下载
  const a = document.createElement("a");
  a.href = URL.createObjectURL(blob);
  a.download = "output.xlsx";
  document.body.appendChild(a);
  a.click();
  document.body.removeChild(a);
}
// 辅助函数：将字符串转换为ArrayBuffer
function s2ab(s) {
  const buf = new ArrayBuffer(s.length);
  const view = new Uint8Array(buf);
  for (let i=0; i<s.length; i++) view[i] = s.charCodeAt(i) & 0xFF;
  return buf;
}