本文介绍如何使用 excel script 遍历源工作表某列，查找指定文本（如 "yes"），并将对应行的公式精准复制到目标工作表的指定列，避免常见索引错位与循环逻辑错误。

在 Excel Script 中实现条件驱动的公式迁移，关键在于同步维护值判断与公式映射的行索引一致性。原始代码中使用 for...of 遍历二维数组 sampleValues（其元素为单元素数组，如 ["Yes"]），再嵌套固定 i=0 的内层循环，导致始终只检查首列首行；同时未将匹配结果写回目标区域，仅执行 console.log，无法完成实际数据操作。

以下为优化后的完整解决方案（已适配实际场景，变量名按问题描述调整为 Sheet "A" 和 Sheet "B"）：

function main(workbook: ExcelScript.Workbook) {
  // 获取目标工作表（Sheet "B"）及待填充的公式列（示例：Column C，即"C4:C200"）
  const destSheet = workbook.getWorksheet("B");
  const destRange = destSheet.getRange("C4:C200"); // 注意：列号需与需求一致（原答案中误写为"E4:E200"，此处修正为"C4:C200"）
  let destFormulas = destRange.getFormulas(); // 获取当前目标区域公式数组（二维，rows × 1）

  // 获取源工作表（Sheet "A"）及用于判断的列（Column B）
  const srcSheet = workbook.getWorksheet("A");
  const srcRange = srcSheet.getRange("B4:B200"); // 范围需与destRange行数对齐（4–200共197行）
  const srcValues = srcRange.getValues();        // 获取值（二维数组：[row][col]）
  const srcFormulas = srcRange.getFormulas();     // 获取对应行的公式（同结构）

  const matchValue = "Yes";

  // 逐行比对，若B列某行为"Yes"，则将该行B列的公式复制到目标列对应行
  for (let i = 0; i < srcValues.length; i++) {
    // srcValues[i] 是一维数组，如 ["Yes"]，需取 [0] 获取字符串值
    if (srcValues[i][0]?.toString().trim().toLowerCase() === matchValue.toLowerCase()) {
      destFormulas[i] = srcFormulas[i]; // 直接赋值公式（保留相对引用、函数等）
    }
  }

  // 一次性写入全部更新后的公式，提升性能
  destRange.setFormulas(destFormulas);
}

✅ 关键改进说明：

• 索引统一：使用标准 for (let i = 0; i
• 安全取值：通过 srcValues[i][0] 显式访问单元格值，并添加可选链 ?. 与 trim()/toLowerCase() 处理空值和大小写，增强鲁棒性；
• 公式优先：使用 .getFormulas() 而非 .getValues()，确保复制的是原始公式（如 =A4*2），而非计算结果；
• 范围对齐：srcRange 与 destRange 行号范围严格一致（如均从第4行开始，覆盖197行），避免越界或漏写；
• 批量写入：最后调用 .setFormulas() 一次性提交，比逐行 .setFormula() 效率更高且更稳定。

⚠️ 注意事项：

• 若源列存在合并单元格，getValues()/getFormulas() 返回值可能不按预期对齐，请先取消合并或改用 getRangeByIndexes() 精确控制；
• 公式中的相对引用（如 B4 中的 =A4+C4）复制到新位置后会自动调整——这是 Excel 默认行为，如需绝对引用请提前在源公式中使用 $ 锁定；
• 测试前建议先备份文件，并在小范围（如 B4:B10）验证逻辑正确性。

通过以上实现，即可高效、准确地完成“查值迁公式”任务，适用于日志标记、自动化报表填充等典型办公自动化场景。