更新记录

0.0.7（2025-07-16）

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

0.0.6（2025-06-08）

• chore: 更新依赖

0.0.5（2025-06-08）

• chore: 更新文档

平台兼容性

uni-app(4.53)

uni-app x(4.61)

lime-xlsx Excel转JSON组件

一个功能强大的Excel文件转JSON工具，支持多种平台包括iOS、Android、Web、鸿蒙Next和小程序。可以轻松将Excel表格数据转换为JSON格式，适用于数据导入、配置读取、表格数据处理等多种应用场景。组件提供了完善的错误处理机制和文件验证功能。

文档链接

📚 组件详细文档请访问以下站点：

• Excel转JSON组件文档 - 站点1
• Excel转JSON组件文档 - 站点2
• Excel转JSON组件文档 - 站点3

安装方法

1. 在uni-app插件市场中搜索并导入lime-xlsx
2. 导入后在项目中引入相关方法
3. 需要自定义基座才能使用

代码演示

UniAppX 示例

使用ts或UniAppX进行Excel文件转换时，需要引入type

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

// 使用示例
excelToJson({
  path: '/static/example.xlsx', // Excel文件路径
  success: (res) => {
    console.log('转换成功:', res.data);
  },
  fail: (err) => {
    console.error('转换失败:', err.errMsg, '错误码:', err.errCode);
  }
} as XlsxOptions);

UniApp 示例

在普通UniApp项目中使用：

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

// 使用示例
excelToJson({
  path: '/static/example.xlsx', // Excel文件路径
  success: (res) => {
    console.log('转换成功:', res.data);
  },
  fail: (err) => {
    console.error('转换失败:', err.errMsg, '错误码:', err.errCode);
  }
});

快速预览

导入插件后，可以直接使用以下标签查看演示效果：

<!-- 代码位于 uni_modules/lime-xlsx/components/lime-xlsx -->
<lime-xlsx />

插件标签说明

详细配置请参考官方文档：Vue Composition API

API文档

XlsxOptions 选项

XlsxResult 结果对象

XlsxError 错误对象

错误码说明

功能特点

• 支持.xlsx格式的Excel文件（安卓还支持.xls）
• 自动将Excel表格数据转换为JSON格式
• 完善的错误处理机制
• 支持大文件检测和限制（默认50MB）
• 支持文件格式验证
• 默认第一行为标题头（keys）
• 默认读取第一个表格（iOS是读取有数据的表格，与其它端有差异）

常见问题

• 小程序不能直接读取xlsx和xls格式的文件，但可以通过将文件后缀改为png后读取
• 小程序使用到getFileSystemManager API，只有支持这个API的小程序才能使用
• iOS和其他平台在读取表格时有差异，iOS会读取有数据的表格
• 确保文件路径正确，且文件格式符合要求
• 大文件处理可能会占用较多内存，请根据实际情况设置maxSize参数

支持与赞赏

如果你觉得本插件解决了你的问题，可以考虑支持作者：

支付宝赞助	微信赞助