Excel写入数据时工作簿卡顿问题求助

问题根源分析 #

• 异步循环处理错误：forEach不支持异步等待，导致多个Excel.run任务并发执行，直接抢占主线程资源，引发工作簿冻结。
• 逐单元格写入开销过高：单个单元格的读写操作IO成本极大，5-8K数据量会产生大量同步请求，拖慢整体速度。
• 频繁上下文同步：每次小操作都调用context.sync()，增加插件与Excel之间的通信开销。
• 重复范围计算：多次调用getUsedRange()会重复计算工作表的使用范围，额外消耗性能。

可行解决方案 #

1. 批量收集所有数据 #

先一次性获取并整理好所有需要写入的数据，再统一执行Excel写入操作，减少与Excel的交互次数。

2. 使用批量范围赋值 #

直接通过单元格范围的values属性批量写入数据，替代逐单元格操作，这是提升Excel写入性能的核心优化点。

3. 合并Excel上下文会话 #

将所有写入操作放在同一个Excel.run会话中，避免多次创建上下文带来的开销。

4. 优化异步循环逻辑 #

用for...of替代forEach处理异步API请求，保证任务串行执行，避免资源竞争。

5. 延迟自动调整操作 #

在所有数据写入完成后，仅执行一次列宽和行高的自动调整，减少重复计算。

优化后的代码示例 #

try {
  const allCompanies = [12,32,33,43,45,66,12,32,10,12,21,90];
  // 批量收集所有需要写入的数据
  const allRows = [];
  // 用for...of保证异步请求串行执行
  for (const company of allCompanies) {
    const responseRows = await fetchData(company);
    // 假设responseRows是二维数组，直接合并到总数据中
    allRows.push(...responseRows);
  }

  // 统一在一个Excel.run会话中写入所有数据
  await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getActiveWorksheet();
    // 直接定位到需要写入的范围，假设从A1开始
    const targetRange = sheet.getRangeByIndexes(0, 0, allRows.length, allRows[0]?.length || 0);
    // 批量赋值
    targetRange.values = allRows;
    
    // 可选：创建表格、设置样式（一次性处理）
    const table = sheet.tables.add(targetRange, true);
    table.style = "TableStyleMedium2"; // 示例样式
    
    // 最后统一调整列宽行高
    table.getRange().format.autofitColumns();
    table.getRange().format.autofitRows();
    
    await context.sync();
  });
} catch (error) {
  console.error("写入Excel时出错:", error);
}

额外优化建议 #

• 如果数据量接近8K行，可以将数据分成多个批次写入（比如每1000行一批），并在批次之间加入短暂延迟（用setTimeout包装成Promise），避免长时间占用主线程。
• 移除不必要的load操作，原代码中sheet.load(["name"])如果未实际使用可直接删除。

内容的提问来源于stack exchange，提问作者Kishan Vaishnani