Excel TypeScript脚本报错：无法读取undefined的getRowIndex属性

问题原因 #

错误「Cannot read properties of undefined (reading 'getRowIndex')」的核心是：lookupRangeAddress.find(substring, {completeMatch: false})返回了undefined——也就是当前子串在查找区域中没有匹配到任何结果，这时强行调用.getRowIndex()就会触发读取undefined属性的报错。

解决方法 #

1. 先校验查找结果，再执行后续操作 #

将查找结果存入变量，先判断其是否存在，再调用行索引方法，避免空值报错：

// 示例完整逻辑
function customVlookup(inputStr: string, lookupRangeAddress: string): string {
  // 拆分输入字符串为36字符的子串数组
  const substrings: string[] = [];
  for (let i = 0; i < inputStr.length; i += 36) {
    substrings.push(inputStr.slice(i, i + 36));
  }

  // 获取查找区域对象
  const lookupRange = ExcelScript.Workbook.getActiveWorkbook().getActiveWorksheet().getRange(lookupRangeAddress);
  const resultParts: (string | number)[] = [];

  for (const sub of substrings) {
    // 先执行查找并存储结果
    const matchResult = lookupRange.find(sub, {completeMatch: false});
    if (matchResult) {
      // 假设取匹配行的第2列作为返回值，可根据需求调整列索引（从0开始计数）
      const rowIdx = matchResult.getRowIndex();
      const matchedValue = lookupRange.getCell(rowIdx, 1).getValue();
      resultParts.push(matchedValue);
    } else {
      // 未找到匹配时的兜底处理，可自定义占位符或空值
      resultParts.push("无匹配");
    }
  }

  // 拼接结果返回
  return resultParts.join("");
}

2. 补充边界场景处理 #

• 拆分后如果出现空字符串子串，提前跳过，避免无效查找
• 确保lookupRangeAddress是合法的Excel区域格式（如"A1:C100"），避免getRange返回无效对象

额外提示 #

• find方法仅返回第一个匹配项，若需要获取所有匹配结果，可改用findAll方法
• TypeScript中建议给变量添加类型注解（如const matchResult: ExcelScript.Range | undefined = ...），能在编译阶段提前发现潜在问题

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