Excel Script 教程：遍历表格并根据匹配条件批量复制公式

本文详解如何使用 excel script 遍历指定列，查找值为 "yes" 的单元格，并将对应行的公式从源工作表复制到目标工作表的指定列，避免常见索引错位与循环逻辑错误。

在 Excel Script 中实现条件式公式迁移，关键在于同步索引、区分值与公式、批量操作提升性能。原始代码中使用 for...of 遍历二维数组 sampleValues（其每个元素实为 [value] 形式的单元素数组），再嵌套固定 i=0 的内层循环，导致始终只检查首列首行——这是典型的数组结构理解偏差。

正确做法是采用传统 for (let i = 0; i

function main(workbook: ExcelScript.Workbook) {
  // 获取目标工作表（"B"）及待填充区域（C列，注意：原答案中示例为"E4:E200"，此处按问题描述修正为"C4:C200"）
  const destSheet = workbook.getWorksheet("B");
  const destRange = destSheet.getRange("C4:C200"); // 目标列：B表的C列
  let destFormulas = destRange.getFormulas(); // 预先获取目标区域全部公式（二维数组）

  // 获取源工作表（"A"）及判断列（B列）
  const srcSheet = workbook.getWorksheet("A");
  const srcRange = srcSheet.getRange("B4:B200"); // 源判断列：A表的B列
  const srcValues = srcRange.getValues();         // [[ "Yes" ], [ "No" ], [ "Yes" ], ...]
  const srcFormulas = srcRange.getFormulas();      // 对应的公式数组，如 [[ "=NOW()" ], [ "" ], [ "=TODAY()" ], ...]

  const matchKey = "Yes";

  // 核心逻辑：逐行比对，匹配则搬运公式
  for (let i = 0; i < srcValues.length; i++) {
    // 注意：srcValues[i] 是单元素数组，需用 toString() 或 [0] 提取字符串
    if (srcValues[i][0]?.toString().trim().toLowerCase() === matchKey.toLowerCase()) {
      destFormulas[i] = srcFormulas[i];
    }
  }

  // 一次性写入所有更新后的公式（高效且原子化）
  destRange.setFormulas(destFormulas);
}

✅ 关键要点说明：

• 索引一致性：srcValues[i][0] 与 srcFormulas[i] 共享同一行索引 i，杜绝偏移；
• 空值安全：使用可选链 ?. 和 trim().toLowerCase() 增强鲁棒性，兼容大小写与前后空格；
• 性能优化：先读取全部公式 → 内存中修改 → 单次 setFormulas() 写回，远优于循环内多次 .getCell().setFormula()；
• 范围对齐：确保 srcRange（B4:B200）与 destRange（C4:C200）行数一致，否则越界访问会静默失败或报错。

⚠️ 注意事项：

• Excel Script 的 getFormulas() 返回的是公式文本（如 "=SUM(A1:A10)"），而非计算结果；若需复制计算值，请改用 getValues()；
• 目标区域 C4:C200 必须已存在且尺寸匹配，建议用动态范围（如 getUsedRange()）替代硬编码；
• 调试时可用 console.log(srcValues.slice(0,5)) 查看前5行实际结构，验证数据格式。

掌握此模式后，可轻松扩展为多条件筛选（如 && srcValues[i][1][0]==="Active"）、跨列映射或公式改造（如 srcFormulas[i].replace("A1","D1")），真正实现自动化报表维护。