LimeXlsx

Excel 文件转 JSON / JSON 转 Excel 工具，支持 IOS/Android/WEB/鸿蒙 Next / 小程序 平台。

功能特点

• 支持 .xlsx 格式的 Excel 文件（安卓还支持 .xls）
• 自动将 Excel 表格数据转换为 JSON 格式
• 支持将 JSON 数据转换为 Excel 文件
• 完善的错误处理机制
• 支持大文件检测和限制（默认 50MB）
• 支持文件格式验证

文档

🚀 xlsx【站点1】
🌍 xlsx【站点2】
🔥 xlsx【站点3】

安装方法

导入，在项目中引入后自定义基座。

使用方法

插件会默认第一行为标题头（keys），默认读取第一个表格。iOS 端读取有数据的表格，与其它端略有差异。

Excel 转 JSON （excelToJson）

在非 TypeScript 环境中，无需引入类型声明，可只使用：

import { excelToJson } from '@/uni_modules/lime-xlsx';

import { excelToJson, type XlsxOptions } from '@/uni_modules/lime-xlsx';

// 使用示例
excelToJson({
  path: '/static/example.xlsx', // Excel 文件路径（小程序不能读取 xlsx 格式，但可改后缀为 png）
  success: (res) => {
    console.log('转换成功:', res.data);
  },
  fail: (err) => {
    console.error('转换失败:', err.errMsg, '错误码:', err.errCode);
  }
} as XlsxOptions);

**如果在 JavaScript 环境中，请去掉 `as XlsxOptions`，直接使用对象字面量即可。**

JSON 转 Excel （jsonToExcel）

在非 TypeScript 环境中，无需引入类型声明，可只使用：

import { jsonToExcel } from '@/uni_modules/lime-xlsx';

import { jsonToExcel, type XlsxOptions } from '@/uni_modules/lime-xlsx';

// 使用示例
jsonToExcel({
  json: JSON.stringify([
    { "name": "Alice", "age": 30 },
    { "name": "Bob", "age": 25 }
  ]), // 直接传入 JSON 字符串
  // 或者使用 path: '/static/data.json'
  success: (res) => {
    console.log('转换成功，文件路径：', res.tempFilePath);
  },
  fail: (err) => {
    console.error('转换失败:', err.errMsg, '错误码:', err.errCode);
  }
} as XlsxOptions);

**如果在 JavaScript 环境中，请去掉 `as XlsxOptions`，直接使用对象字面量即可。**

错误码说明

错误码	说明
9010001	文件读取失未加载
9010002	文件不存在，请检查文件路径
9010003	文件格式不支持，仅支持 .xlsx 或 .xls 格式
9010004	文件为空或没有数据 / 无效的输入
9010005	文件解析失败，可能是文件已损坏 / JSON 处理失败
9010006	文件过大，超出处理限制
9010007	文件写入失败 / JSON 转 Excel 失败
9010008	临时文件创建失败
9010009	无效的文件路径格式

源代码

组件源码