更新记录
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)
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | √ | √ | √ |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | √ | √ | √ | - | - |
uni-app x(4.61)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ |
lime-xlsx
Excel文件转JSON工具,IOS/Android/WEB/鸿蒙Next/小程序平台。
功能特点
- 支持.xlsx格式的Excel文件(安卓还支持.xls)
- 自动将Excel表格数据转换为JSON格式
- 完善的错误处理机制
- 支持大文件检测和限制(默认50MB)
- 支持文件格式验证
文档
🚀 xlsx【站点1】 🌍 xlsx【站点2】 🔥 xlsx【站点3】
安装方法
插件市场导入,在项目中引入后自定义基座
使用方法
插件会默认第一行为标题头(keys),默认读取第一个表格。IOS是读取有数据的表格,跟其它端有点差异。
UNIAPPX
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);
UNIAPP
import { excelToJson } 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);
}
});
错误码说明
错误码 | 说明 |
---|---|
9010001 | 文件读取失败,请检查文件格式是否正确 |
9010002 | 文件不存在,请检查文件路径 |
9010003 | 文件格式不支持,仅支持.xlsx或.xls格式 |
9010004 | 文件为空或没有数据 |
9010005 | 文件解析失败,可能是文件已损坏 |
9010006 | 文件过大,超出处理限制 |
9010007 | JSON转换失败 |
9010008 | 临时文件创建失败 |
9010009 | 无效的文件路径格式 |
常见问题
1、小程序好像不能直接读取xlsx
和xls
格式的文件,但把它改成png
后缀就能读取,这个问有没有大佬知道如何解决?
2、小程序用到getFileSystemManager
API,只有支持这个API的小程序才能使用