使用google-spreadsheets npm包时addRows()未覆盖行而是追加如何解决

问题根因 #

• addRows() 方法原生定位为行追加操作，官方文档提及的覆盖类参数仅适用于行主键匹配时的单值覆盖场景，不支持全量覆盖已有表格内容的需求
• 逐行调用row.delete()会触发大量独立API请求，极易触发Google Sheets API限流规则，导致运行速度慢、中途执行失败

解决方案 #

方案1：全量覆盖（含表头清空） #

仅需两次API请求即可完成操作，效率最高，适用于不需要保留原有表头的场景：

const { GoogleSpreadsheet } = require('google-spreadsheet');

// 初始化表格实例、鉴权逻辑省略
const doc = new GoogleSpreadsheet('你的表格ID');
await doc.useServiceAccountAuth(你的鉴权配置);
await doc.loadInfo();

const targetSheet = doc.sheetsByTitle['目标工作表名称']; // 也可使用sheetsByIndex指定下标
// 清空工作表所有单元格内容
await targetSheet.clear();
// 写入新行数据，此时效果等同于全量覆盖原有内容
await targetSheet.addRows(你要写入的行数据数组);

方案2：保留表头覆盖 #

如果需要保留原有表头行，使用批量删除方法替代逐行删除：

await targetSheet.loadHeaderRow(); // 加载原有表头
const totalRows = targetSheet.rowCount;
// 存在数据行时批量删除，仅保留第1行表头
if (totalRows > 1) {
  await targetSheet.deleteRows(2, totalRows - 1);
}
// 写入新数据
await targetSheet.addRows(你要写入的行数据数组);

补充说明 #

• clear()方法仅清空单元格内容，不会删除表格的冻结行、条件格式、筛选规则等配置
• 上述方案所有操作均为批量API请求，不会触发接口限流，不存在运行中断问题

内容的提问来源于stack exchange，提问作者Álvaro