自动化助手

    $excel - 表格操作

    • 更新时间:2026-02-08 19:43:37

    表格操作

    用于读取和写入二维数组到表格中，这个库需要在安卓8+的系统上才能完美运行。

    读取(路径)

    读取第一个表格

    • 参数 : 路径 {字符串} 路径(支持相对路径)
    • 返回 : {字符串[][]} 表格数据
    • 版本 : 1.7.8
    //读取第一个表格数据
定义 数据 = $表格.读取("data.xlsx");//相对路径
日志(数据);
// 输出:
// [
//    ["学号","姓名","年龄","性别","入学日期"],
//    ["2023001","张三","20","男","2023-09-01"],
//    ["2023002","李四","19","女","2023-09-01"],
//    ["2023003","王五","21","男","2022-09-01"],
//    ["2023004","赵六","20","女","2023-09-01"]
// ]

    读取(路径, 下标)

    读取表格

    • 参数 : 路径 {字符串} 路径(支持相对路径)
    • 参数 : 下标 {整数} 表格索引
    • 返回 : {String[][]} 表格数据
    • 版本 : 1.7.8
    //读取第2个表格数据
定义 数据 = $表格.读取("data.xlsx", 1);//相对路径
日志(数据);
// 输出:
// [
//    ["商品ID","商品名称","商品单价","库存"],
//    ["P001","笔记本电脑","4999","10"],
//    ["P002","智能手机","3999","25"],
//    ["P003","平板电脑","2499","18"],
//    ["P004","无线耳机","799","50"]
// ]

    数量(路径)

    表格数量

    • 参数 : 路径 {字符串} 路径(支持相对路径)
    • 返回 : {整数} 表格数量
    • 版本 : 1.7.8
    //获取表格的数量
定义 表格数量 = $表格.数量("data.xlsx");//相对路径
日志(表格数量);//输出:3

    罗列(路径)

    列表

    • 参数 : 路径 {字符串} 路径(支持相对路径)
    • 返回 : {字符串数组[]} 表格名称列表
    • 版本 : 1.7.8
    //获取表格的数量
定义 表格列表 = $表格.罗列("data.x罗列x");//相对路径
日志(表格列表);//输出:["班级表","商品表","部门表"]

    遍历(表格路径, 数据回调)

    遍历所有表格

    • 参数 : 表格路径 {字符串} 路径(支持相对路径)
    • 参数 : 数据回调 {(名称,数据)=>{}} 数据回调
    • 版本 : 1.7.8
    //遍历所有表格数据
$表格.遍历("data.xlsx", (名称, 数据) => {
    提示(名称,数据);
});

    写入(表格名称, 表格数据, 保存路径)

    写入表格

    • 参数 : 表格名称 {字符串} 表格名称
    • 参数 : 表格数据 {String[][]} 表格数据
    • 参数 : 保存路径 {字符串} 保存路径(不支持相对路径,必须是绝对路径)
    • 版本 : 1.7.8
    //数据
定义 表格数据 = [
    ["姓名", "年龄"],
    ["小红", "18"],//注意必须都是字符串类型
    ["小明", "19"]
];
//表名
定义 表格名称 = "我的表格";
//路径(必须是绝对路径)
定义 保存路径 = "/sdcard/demo.xlsx";
$表格.写入(表格名称, 表格数据, 保存路径);