簡介

本文介紹用 Node.js 中的 js-xlsx 庫來處理 Excel 文件。

js-xlsx 庫是目前 Github 上 star 數(shù)量最多的處理 Excel 的庫，功能強(qiáng)大，但上手難度稍大。文檔有些亂，不適合快速上手。

本文對 js-xlsx 庫進(jìn)行一定的總結(jié)，并提供幾個實(shí)用的例子供讀者測試，學(xué)習(xí)，交流。

安裝

$ npm install xlsx

一些概念

在使用這個庫之前，先介紹庫中的一些概念。

它們的關(guān)系如下：

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

用法

基本用法

具體用法

讀取 Excel 文件

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

獲取 Excel 文件中的表

// 獲取 Excel 中所有表名const sheetNames = workbook.SheetNames; // 返回 ['sheet1', 'sheet2']// 根據(jù)表名獲取對應(yīng)某張表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 } } ]

實(shí)戰(zhàn)

解析 Excel 生成 JSON

Tips 事實(shí)上，你可以直接通過 XLSX.utils.sheet_to_json(worksheet) 獲得同樣的結(jié)果

注意 本例子中假設(shè)表的第一行為字段名

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));  // 當(dāng)前單元格的值  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 } ... ]