在自动化流程开发中Excel文件操作是一项非常高频的基础需求。无论是批量处理用户数据、导出报表还是作为配置文件的读写媒介Excel都是绕不开的环节。本文将系统梳理冰狐平台原生提供的Excel操作API从创建、写入、读取到行列管理给出完整的方法说明与代码示例。一、Excel 对象与文件路径约定冰狐平台通过内置的Excel构造函数来操作Excel文件。使用前需要先实例化var excel new Excel();平台对文件路径有明确的约定文件名不需要添加后缀名如.xls平台会自动处理。路径参数为选填默认为空字符串此时文件存放在手机目录下的aznfz文件夹里。如果指定path参数则可以自定义存放路径。二、创建 Excel 文件create创建新文件使用create方法返回布尔值表示操作是否成功。方法签名excel.create(fileName, colTitle, path)参数类型必填说明fileNamestring是文件名不需要加后缀colTitlearray是列标题数组pathstring否路径默认为空aznfz目录示例创建名为temp的Excel文件列标题分别为“名称”、“值”、“价格”var excel new Excel(); var ret excel.create(temp, [名称, 值, 价格]); console.log(create ret: ret);创建成功后文件即生成在指定目录下后续的写入操作基于此文件进行。三、打开已有文件open如果需要操作已存在的Excel文件使用open方法。方法签名excel.open(fileName, path)参数类型必填说明fileNamestring是文件名不需要加后缀pathstring否路径默认为空aznfz目录返回布尔值表示是否成功打开文件。注意read方法只能在open成功调用后才能使用。四、写入数据1. addRow —— 按行写入addRow用于向文件写入一行数据返回布尔值。方法签名excel.addRow(data, row)参数类型必填说明dataarray是数据数组个数必须与列数一致rowinteger否行号默认为 -1表示在末尾追加示例excel.addRow([jack, 经济, 112]);2. append —— 追加到末尾append是addRow的简化版本专门用于在文件末尾添加一行数据。调用成功后会立即写入文件无需额外操作。方法签名excel.append(data)参数类型必填说明dataarray是数据数组个数必须与列数一致示例var excel new Excel(); excel.open(temp); excel.append([hello, 111]); excel.close();append与addRow的核心区别在于append固定追加到末尾且立即落盘而addRow可以通过row参数指定任意行号写入。五、关闭文件close所有操作完成后务必调用close方法关闭文件。excel.close();关闭文件不仅释放资源也确保所有缓冲数据完整写入磁盘。建议在任何写入操作结束后都显式调用close。六、读取数据readread方法用于读取Excel中的数据返回数组。注意必须先调用open成功打开文件后才能使用read。方法签名excel.read(row)参数类型必填说明rowinteger否行号若不填则返回表格所有数据用法示例excel.open(temp); var allData excel.read(); // 读取所有数据 var rowData excel.read(2); // 读取第2行数据 console.log(allData); excel.close();七、获取行列数rows / columnsrows和columns方法分别返回文件的总行数和总列数。var rowCount excel.rows(); var colCount excel.columns(); console.log(总行数 rowCount 总列数 colCount);这两个方法在遍历数据或进行边界检查时非常实用。八、删除操作removeRow / removeColumn1. removeRow —— 删除指定行删除指定行号的数据。excel.removeRow(3); // 删除第3行2. removeColumn —— 删除指定列删除指定列号的数据。excel.removeColumn(2); // 删除第2列注意行号和列号均从1开始计数与常规表格习惯一致。九、完整流程示例下面是一个完整的操作流程覆盖创建、写入、读取、修改和关闭的全链路// 1. 创建实例 var excel new Excel(); // 2. 创建新文件 var ret excel.create(sales_data, [产品, 销量, 单价]); console.log(创建结果 ret); // 3. 写入多行数据 excel.addRow([手机, 120, 2999]); excel.addRow([平板, 85, 3999]); excel.append([耳机, 200, 499]); // 4. 读取所有数据并输出 var all excel.read(); console.log(当前数据, all); // 5. 获取行列数 console.log(行数 excel.rows() 列数 excel.columns()); // 6. 删除第2行 excel.removeRow(2); // 7. 再次读取验证 var afterDelete excel.read(); console.log(删除后数据, afterDelete); // 8. 关闭文件 excel.close(); console.log(操作完成);十、常见问题与注意事项1. 文件名不需要加后缀无论是create还是open传入的fileName都不需要带.xls或.xlsx后缀平台会自动处理。2. 数据长度必须与列数一致调用addRow或append时传入的数据数组长度必须与创建时设定的列标题数量相同否则操作会失败。3. read 必须在 open 之后read方法依赖已打开的文件句柄未调用open直接read会导致错误。4. 及时 close写入操作完成后建议立即调用close避免数据丢失或文件占用问题。5. 路径说明不指定path时文件默认存放在手机目录的aznfz文件夹下。如需存放到其他位置可通过path参数指定绝对路径。