本文详解如何使用 excel script 编写健壮的 for 循环，自动扫描源工作表某列中值为 "yes" 的行，并将对应行的公式精准复制到目标工作表指定列，避免常见索引错位与类型比较陷阱。
在 Excel Script 开发中，实现「条件驱动的公式批量迁移」是高频需求——例如根据审核状态（如 "Yes"）自动同步计算逻辑。但初学者常陷入两个典型误区：一是误用 for...of 遍历二维数组导致索引丢失（sampleValues 实际是 number[][]，每项为 [value]），二是忽略 .getValues() 返回的是嵌套数组，直接比较 index[i] == str 会因类型/结构不匹配而失效。
以下为优化后的生产级实现，以实际场景命名（替代泛化的 "Sheet A/B"）便于理解：
阿拉丁·Excel 图表生成器
下载
Excel 数据可视化图表生成器 - 把 Excel/表格数据一键转为柱状图、折线图、饼图、雷达图、堆叠柱状图、散点图、面积图、环形图、气泡图、极坐标图、水平柱状图、柱+线组合双轴图。支持数据透视后绘图(--pivot),输出交互式 HTML(可悬停查看数值、一键下载 PNG)与静态 PNG(可嵌入文档/PPT)。提供两套配色方案: cn-stock(涨红跌绿, 金融财报默认) 与 vibrant(明亮风格, 适合演示报告)。当用户提到数据可视化、画图、图表、走势图、占比图、趋势图、对比图、透视表、Exc
function main(workbook: ExcelScript.Workbook) {
// ✅ 步骤1：明确获取目标工作表与范围（推荐使用精确范围，避免整列性能损耗）
const targetSheet = workbook.getWorksheet("Testing"); // 对应原文中的 "Sheet B"
const targetRange = targetSheet.getRange("C4:C200"); // 目标粘贴列：Testing!C4:C200
let targetFormulas = targetRange.getFormulas(); // 预先读取目标区域公式数组（二维）
// ✅ 步骤2：获取源数据（注意范围对齐！C4:C200 ↔ C4:C200 行数必须一致）
const sourceSheet = workbook.getWorksheet("Fermenter Log"); // 对应原文中的 "Sheet A"
const sourceRange = sourceSheet.getRange("B4:B200"); // 源判断列：Fermenter Log!B4:B200
const sourceValues = sourceRange.getValues(); // [[val1], [val2], ...]
const sourceFormulas = sourceRange.getFormulas(); // [[formula1], [formula2], ...]
// ✅ 步骤3：逐行比对并填充（关键：使用标准 for 循环 + 显式索引）
const matchKey = "Yes";
for (let i = 0; i < sourceValues.length; i++) {
// ? 核心修复：sourceValues[i] 是单元素数组，需取 [0]；且用严格相等 === 防止类型转换错误
if (sourceValues[i][0] === matchKey) {
targetFormulas[i][0] = sourceFormulas[i][0]; // 将源公式赋给目标对应位置
}
}
// ✅ 步骤4：一次性写入（高效！避免循环内多次 setFormulas）
targetRange.setFormulas(targetFormulas);
}关键注意事项：
- 范围对齐强制要求：sourceRange 与 targetRange 必须行数完全相同（如均为 197 行），否则 i 越界或漏写；建议用动态范围（如 getUsedRange()）或提前校验 sourceValues.length === targetFormulas.length。
- 公式 vs 值：本方案复制的是 getFormulas()（即 =SUM(A1:A10) 这类公式），若需复制计算结果则改用 getValues()。
- 大小写敏感："Yes" 匹配区分大小写，如需忽略大小写，改为 String(sourceValues[i][0]).toUpperCase() === "YES"。
- 空单元格处理：sourceValues[i][0] 可能为 undefined 或 null，生产环境建议增加 if (sourceValues[i][0] && String(sourceValues[i][0]).trim() === matchKey)。
此方案通过显式索引控制 + 二维数组解构 + 批量写入，彻底规避了原代码中 for...of 导致的索引固化问题，同时提升执行效率与可维护性。
