Node.js利用js-xlsx处理Excel文件的方法详解

简介

本文介绍用 Node.js 中的 js-xlsx 库来处理 Excel 文件。

js-xlsx 库是目前 Github 上 star 数量最多的处理 Excel 的库，功能强大，但上手难度稍大。文档有些乱，不适合快速上手。

本文对 js-xlsx 库进行一定的总结，并提供几个实用的例子供读者测试，学习，交流。

安装

$ npm install xlsx

一些概念

在使用这个库之前，先介绍库中的一些概念。

• workbook 对象，指的是整份 Excel 文档。我们在使用 js-xlsx 读取 Excel 文档之后就会获得 workbook 对象。
• worksheet 对象，指的是 Excel 文档中的表。我们知道一份 Excel 文档中可以包含很多张表，而每张表对应的就是 worksheet 对象。
• cell 对象，指的就是 worksheet 中的单元格，一个单元格就是一个 cell 对象。
  

它们的关系如下：

// workbook
{
 SheetNames: ['sheet1', 'sheet2'],
 Sheets: {
 // worksheet
 'sheet1': {
  // cell
  'A1': { ... },
  // cell
  'A2': { ... },
  ...
 },
 // worksheet
 'sheet2': {
  // cell
  'A1': { ... },
  // cell
  'A2': { ... },
  ...
 }
 }
}

用法

基本用法

• 用 XLSX.readFile 打开 Excel 文件，返回 workbook
• 用 workbook.SheetNames 获取表名
• 用 workbook.Sheets[xxx] 通过表名获取表格
• 按自己的需求去处理表格
• 生成新的 Excel 文件
  

具体用法

读取 Excel 文件

import XLSX from 'xlsx';
const workbook = XLSX.readFile('someExcel.xlsx', opts);

获取 Excel 文件中的表

// 获取 Excel 中所有表名
const sheetNames = workbook.SheetNames; // 返回 ['sheet1', 'sheet2']
// 根据表名获取对应某张表
const worksheet = workbook.Sheets[sheetNames[0]];

通过 worksheet[address] 来操作表格，以 ! 开头的 key 是特殊的字段。

// 获取 A1 单元格对象
let a1 = worksheet['A1']; // 返回 { v: 'hello', t: 's', ... }
// 获取 A1 中的值
a1.v // 返回 'hello'

// 获取表的有效范围
worksheet['!ref'] // 返回 'A1:B20'
worksheet['!range'] // 返回 range 对象，{ s: { r: 0, c: 0}, e: { r: 100, c: 2 } }

// 获取合并过的单元格
worksheet['!merges'] // 返回一个包含 range 对象的列表，[ {s: { r: 0, c: 0 }, c: { r: 2, c: 1 } } ]

实战

解析 Excel 生成 JSON

Tips 事实上，你可以直接通过 XLSX.utils.sheet_to_json(worksheet) 获得同样的结果

注意 本例子中假设表的第一行为字段名

const headers = {};
const data = [];
const keys = Object.keys(worksheet);
keys
 // 过滤以 ! 开头的 key
 .filter(k => k[0] !== '!')
 // 遍历所有单元格
 .forEach(k => {
  // 如 A11 中的 A
  let col = k.substring(0, 1);
  // 如 A11 中的 11
  let row = parseInt(k.substring(1));
  // 当前单元格的值
  let value = worksheet[k].v;

  // 保存字段名
  if (row === 1) {
   headers[col] = value;
   return;
  }

  // 解析成 JSON
  if (!data[row]) {
   data[row] = {};
  }
  data[row][headers[col]] = value;
 });

console.log(data); // [ { '姓名': 'test1', '年龄': 20 }, { '姓名': 'test2', '年龄': 10 } ... ]

合并表格

步骤：

• 读取多份表格
• 合并数组
  

Tips: 其实合并表格跟 XLSX 没什么关系，只是处理几个数组而已。

sheet1

id	name	age
1	test1	30
2	test2	20
3	test3	18

sheet2

id	country	remark
1	China	hello
2	America	world
3	Unkonw	???

let sheet1 = XLSX.utils.sheet_to_json(sheet1);
let sheet2 = XLSX.utils.sheet_to_json(sheet2);

// 先合并 sheet1 和 sheet2，再对统一处理
const result = sheet1.concat(sheet2).reduce((prev, next) => {
 let index = prev.findIndex((elem, i) => elem.id === next.id);

 if (index === -1) {
  return prev.concat(next);
 } else {
  prev[index] = Object.assign({}, prev[index], next);
  return prev;
 }
}, []);
console.log(result);

// [ { id: '1',
// name: 'test1',
// age: '30',
// country: 'China',
// remark: 'hello' },
// { id: '2',
// name: 'test2',
// age: '20',
// country: 'America',
// remark: 'world' },
// { id: '3',
// name: 'test3',
// age: '18',
// country: 'Unkonw',
// remark: '???' } ]

导出表格

步骤：

• 构建特定的数据结构，如下。
• 调用 XLSX.writeFile(workbook, filename) 即可。
  

// workbook
{
 SheetNames: ['mySheet'],
 Sheets: {
  'mySheet': {
   '!ref': 'A1:E4', // 必须要有这个范围才能输出，否则导出的 excel 会是一个空表
   A1: { v: 'id' },
   ...
  }
 }
}

var _headers = ['id', 'name', 'age', 'country', 'remark']
var _data = [ { id: '1',
    name: 'test1',
    age: '30',
    country: 'China',
    remark: 'hello' },
    { id: '2',
    name: 'test2',
    age: '20',
    country: 'America',
    remark: 'world' },
    { id: '3',
    name: 'test3',
    age: '18',
    country: 'Unkonw',
    remark: '???' } ];

var headers = _headers
    // 为 _headers 添加对应的单元格位置
    // [ { v: 'id', position: 'A1' },
    // { v: 'name', position: 'B1' },
    // { v: 'age', position: 'C1' },
    // { v: 'country', position: 'D1' },
    // { v: 'remark', position: 'E1' } ]
    .map((v, i) => Object.assign({}, {v: v, position: String.fromCharCode(65+i) + 1 }))
    // 转换成 worksheet 需要的结构
    // { A1: { v: 'id' },
    // B1: { v: 'name' },
    // C1: { v: 'age' },
    // D1: { v: 'country' },
    // E1: { v: 'remark' } }
    .reduce((prev, next) => Object.assign({}, prev, {[next.position]: {v: next.v}}), {});

var data = _data
    // 匹配 headers 的位置，生成对应的单元格数据
    // [ [ { v: '1', position: 'A2' },
    //  { v: 'test1', position: 'B2' },
    //  { v: '30', position: 'C2' },
    //  { v: 'China', position: 'D2' },
    //  { v: 'hello', position: 'E2' } ],
    // [ { v: '2', position: 'A3' },
    //  { v: 'test2', position: 'B3' },
    //  { v: '20', position: 'C3' },
    //  { v: 'America', position: 'D3' },
    //  { v: 'world', position: 'E3' } ],
    // [ { v: '3', position: 'A4' },
    //  { v: 'test3', position: 'B4' },
    //  { v: '18', position: 'C4' },
    //  { v: 'Unkonw', position: 'D4' },
    //  { v: '???', position: 'E4' } ] ]
    .map((v, i) => _headers.map((k, j) => Object.assign({}, { v: v[k], position: String.fromCharCode(65+j) + (i+2) })))
    // 对刚才的结果进行降维处理（二维数组变成一维数组）
    // [ { v: '1', position: 'A2' },
    // { v: 'test1', position: 'B2' },
    // { v: '30', position: 'C2' },
    // { v: 'China', position: 'D2' },
    // { v: 'hello', position: 'E2' },
    // { v: '2', position: 'A3' },
    // { v: 'test2', position: 'B3' },
    // { v: '20', position: 'C3' },
    // { v: 'America', position: 'D3' },
    // { v: 'world', position: 'E3' },
    // { v: '3', position: 'A4' },
    // { v: 'test3', position: 'B4' },
    // { v: '18', position: 'C4' },
    // { v: 'Unkonw', position: 'D4' },
    // { v: '???', position: 'E4' } ]
    .reduce((prev, next) => prev.concat(next))
    // 转换成 worksheet 需要的结构
    // { A2: { v: '1' },
    //  B2: { v: 'test1' },
    //  C2: { v: '30' },
    //  D2: { v: 'China' },
    //  E2: { v: 'hello' },
    //  A3: { v: '2' },
    //  B3: { v: 'test2' },
    //  C3: { v: '20' },
    //  D3: { v: 'America' },
    //  E3: { v: 'world' },
    //  A4: { v: '3' },
    //  B4: { v: 'test3' },
    //  C4: { v: '18' },
    //  D4: { v: 'Unkonw' },
    //  E4: { v: '???' } }
    .reduce((prev, next) => Object.assign({}, prev, {[next.position]: {v: next.v}}), {});

// 合并 headers 和 data
var output = Object.assign({}, headers, data);
// 获取所有单元格的位置
var outputPos = Object.keys(output);
// 计算出范围
var ref = outputPos[0] + ':' + outputPos[outputPos.length - 1];

// 构建 workbook 对象
var wb = {
 SheetNames: ['mySheet'],
 Sheets: {
  'mySheet': Object.assign({}, output, { '!ref': ref })
 }
};

// 导出 Excel
XLSX.writeFile(wb, 'output.xlsx');

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对的支持。

出处

http://scarletsky.github.io/2016/01/30/nodejs-process-excel/

参考资料

https://github.com/SheetJS/js-xlsx

http://stackoverflow.com/questions/30859901/parse-xlsx-with-node-and-create-json

# nodejs读取excel文件  # node  # xlsx  # 读取excel  # 导出excel  # @vue/cli4升级@vue/cli5 node.js polyfills错误的解决方式  # 利用Chrome DevTools直接调试Node.js和JavaScript的方法详解(并行)  # Node.js与Sails ~项目结构与Mvc实现及日志机制  # node.js中的fs.lstatSync方法使用说明  # Node.js 构建命令行工具之实现 ls 命令的 -a&n  # 单元格  # 文档  # 几个  # 指的是  # 转换成  # 自己的  # 是一个  # 字段名  # 就会  # 你可以  # 要有  # 遍历  # 数据结构  # 不适合  # 这篇文章  # 谢谢大家  # 参考资料  # 使用这个  # 计算出  # 再对 

相关文章： 北京网站制作公司哪家好一点,北京租房网站有哪些？  C++时间戳转换成日期时间的步骤和示例代码  建站之星IIS配置教程：代码生成技巧与站点搭建指南  如何在阿里云香港服务器快速搭建网站？  建站之星各版本价格是多少？  建站之星伪静态规则如何设置？  如何通过西部数码建站助手快速创建专业网站？  免费ppt制作网站,有没有值得推荐的免费PPT网站？  制作企业网站建设方案,怎样建设一个公司网站？  小建面朝正北，A点实际方位是否存在偏差？  如何在建站主机中优化服务器配置？  如何在IIS7中新建站点？详细步骤解析  专业的网站制作设计是什么,如何制作一个企业网站，建设网站的基本步骤有哪些？  如何选择高效便捷的WAP商城建站系统？  长沙做网站要多少钱,长沙国安网络怎么样？  如何快速生成ASP一键建站模板并优化安全性？  宁波免费建站如何选择可靠模板与平台？  如何快速搭建二级域名独立网站？  建站之星安装提示数据库无法连接如何解决？  建站主机数据库如何配置才能提升网站性能？  制作网站怎么制作,*游戏网站怎么搭建？  头像制作网站在线制作软件,dw网页背景图像怎么设置？  为什么Go需要go mod文件_Go go mod文件作用说明  小视频制作网站有哪些,有什么看国内小视频的网站，求推荐？  香港网站服务器数量如何影响SEO优化效果？  ppt在线制作免费网站推荐,有什么下载免费的ppt模板网站？  金*站制作公司有哪些,金华教育集团官网？  常州企业网站制作公司,全国继续教育网怎么登录？  高性能网站服务器配置指南：安全稳定与高效建站核心方案  猪八戒网站制作视频,开发一个猪八戒网站，大约需要多少？或者自己请程序员，需要什么程序员，多少程序员能完成？  如何在服务器上配置二级域名建站？  如何在腾讯云免费申请建站？  开心动漫网站制作软件下载,十分开心动画为何停播？  建站主机CVM配置优化、SEO策略与性能提升指南  单页制作网站有哪些,朋友给我发了一个单页网站，我应该怎么修改才能把他变成自己的呢，请求高手指点迷津？  如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？  广东企业建站网站优化与SEO营销核心策略指南  沈阳制作网站公司排名,沈阳装饰协会官方网站？  广州商城建站系统开发成本与周期如何控制？  建站之星云端配置指南：模板选择与SEO优化一键生成  浅析上传头像示例及其注意事项  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用？  如何自定义建站之星网站的导航菜单样式？  如何快速使用云服务器搭建个人网站？  如何用5美元大硬盘VPS安全高效搭建个人网站？  如何用搬瓦工VPS快速搭建个人网站？  Python多线程使用规范_线程安全解析【教程】  建站与域名管理如何高效结合？  ppt制作免费网站有哪些,ppt模板免费下载网站？  如何通过多用户协作模板快速搭建高效企业网站？