【完全免费】三步用 JavaScript 读取 Excel:xlsx.full.min.js 最简使用指南

原创2026-11-15 13:19:581,420 阅读
文章标签:数据工程

【完全免费】三步用 JavaScript 读取 Excel:xlsx.full.min.js 最简使用指南

这个项目是一个用于在 JavaScript 中读取 Excel 的官方工具包 xlsx.full.min.js:它帮你打开 .xlsx 文件,并把内容直接转成 JSON。适合需要在 Node 或浏览器项目里用代码处理 Excel 数据的人。

以前用 JS 读 Excel 有多麻烦

想在 JS 里拿到表格中的一个单元格,过去要么自己解析文件内部结构,要么把数据甩给后端处理,链路长、调试成本高。xlsx.full.min.js 把这整套操作打包成一个文件:引入之后,就能读工作簿、把表数据直接输出成 JSON。

它能为你做些什么

  • 读取 .xlsx 文件:一行代码打开工作簿,不用自己解析文件结构
  • 精确取指定单元格:只需要某一条数据时,直接拿到对应值
  • 整表转 JSON 字符串:内容直接输出成 JSON,存库、转发都方便
  • 单文件即全部:下载后丢进项目即可,省掉复杂安装步骤

四步拿到 Excel 数据

  1. 下载:执行 git clone https://gitcode.com/open-source-toolkit/b0fc2 获取 xlsx.full.min.js(根目录另有打包版 xlsx.full.min.zip)
  2. 引入:把文件放进你的项目,用 require 加载
  3. 调用:用 XLSX.readFile 读取目标 .xlsx 文件
  4. 转换:用 sheet_to_json 把工作表输出为 JSON

跑通第一个读取例子

下面这段代码完成了"读文件 → 取第一个工作表 → 转 JSON"的完整流程:

const XLSX = require('xlsx.full.min.js');
const workbook = XLSX.readFile('example.xlsx');
const firstSheetName = workbook.SheetNames[0];
const worksheet = workbook.Sheets[firstSheetName];
const jsonData = XLSX.utils.sheet_to_json(worksheet);
console.log(jsonData);

动手前检查这几项

  • 确认 xlsx.full.min.js 真的在项目中,require 路径指向的是真实文件
  • 检查 XLSX.readFile 里的路径,相对路径要对着当前工作目录核对一遍
  • 确认要读的文件是 .xlsx 格式,这是该工具包明确支持的格式
  • 转成 JSON 后按需做过滤、入库,字段类型可以先检查一下

参与与授权

使用中遇到问题或有改进想法,直接提交 Issue 或 Pull Request 即可。项目采用 MIT 许可证发布,详见 LICENSE。

登录后查看全文
xlsx.full.min.js官方工具包-用于JavaScript读取Excel文件