Power Automate云流中Office Script匹配复制数据报错求助

错误Cannot read properties of null (reading 'length')出现在第10行，核心原因是matchColumn变量为null。追根溯源，matchColumn由form1.getRange("A:A").getValues()生成，说明form1是null——也就是workbook.getWorksheet("Form1")未找到对应工作表，大概率是工作表名称拼写错误（比如大小写、空格差异，实际表名可能是Form 1而非Form1）。此外，Sheet 1和Sheet 2也可能存在同样的名称匹配问题。

function main(workbook: ExcelScript.Workbook) {
  // 获取工作表并做存在性校验
  const sheet1 = workbook.getWorksheet("Sheet 1");
  const sheet2 = workbook.getWorksheet("Sheet 2");
  const form1 = workbook.getWorksheet("Form1");

  if (!sheet1 || !sheet2 || !form1) {
    throw new Error("请检查工作表名称是否正确，确保Sheet 1、Sheet 2、Form1存在");
  }

  // 获取需要匹配的值
  const valueToMatch = sheet1.getRange("K7").getValue();
  if (valueToMatch === "") {
    throw new Error("Sheet1的K7单元格为空，无法进行匹配");
  }

  // 获取Form1中A列的实际使用范围（避免读取整列空数据）
  const matchColumnRange = form1.getRange("A:A").getUsedRange();
  if (!matchColumnRange) {
    throw new Error("Form1的A列无数据");
  }
  const matchColumn = matchColumnRange.getValues();

  // 遍历匹配行
  for (let i = 0; i < matchColumn.length; i++) {
    // 处理类型不一致的匹配问题（比如数字转字符串）
    if (String(matchColumn[i][0]) === String(valueToMatch)) {
      const rowToCopy = matchColumnRange.getRowIndex() + i + 1; // 基于实际使用范围的行号

      // 批量赋值，减少重复API调用
      const formRowValues = form1.getRange(`A${rowToCopy}:N${rowToCopy}`).getValues()[0];
      sheet2.getRange("H1").setValue(formRowValues[4]); // E列对应索引4
      sheet2.getRange("H3").setValue(formRowValues[1]); // B列对应索引1
      sheet2.getRange("H5").setValue(formRowValues[0]); // A列对应索引0
      sheet2.getRange("C10").setValue(formRowValues[6]); // G列对应索引6
      sheet2.getRange("C12").setValue(formRowValues[7]); // H列对应索引7
      sheet2.getRange("C14").setValue(formRowValues[8]); // I列对应索引8
      sheet2.getRange("C15").setValue(formRowValues[9]); // J列对应索引9
      sheet2.getRange("C16").setValue(formRowValues[10]); // K列对应索引10
      sheet2.getRange("C17").setValue(formRowValues[11]); // L列对应索引11
      sheet2.getRange("C20").setValue(formRowValues[12]); // M列对应索引12
      sheet2.getRange("C22").setValue(formRowValues[13]); // N列对应索引13

      break; // 匹配到后退出循环
    }
  }
}

• 工作表存在性校验：添加if (!sheet1 || !sheet2 || !form1)判断，提前捕获名称错误问题，给出明确提示
• 使用实际数据范围：用getUsedRange()替代整列读取，避免加载大量空行数据，提升脚本运行效率
• 类型统一匹配：用String()转换匹配值，解决数字与字符串类型不一致导致的匹配失败问题
• 批量读取行数据：一次性读取Form1对应行的所有需要的列数据，减少重复的getRange调用，优化性能
• 空值检查：对Sheet1的K7单元格和Form1的A列数据做空值判断，避免无意义的遍历

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