本文详解如何使用 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")），真正实现自动化报表维护。
