更新记录

0.0.8（2025-10-17）

• feat: 增加jsonToExcel

0.0.7（2025-07-16）

• fix: 修复ios键值不对应的问题

0.0.6（2025-06-08）

• chore: 更新依赖

平台兼容性

uni-app(4.53)

uni-app x(4.61)

lime-xlsx

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`，直接使用对象字面量即可。**

错误码说明