Google Sheets多表合并脚本报错：Exception: Range not found 求助

核心错误定位 #

1. 第26行「Range not found」异常原因
   代码中getRange("masterSheetFormulaCell")直接用字符串作为范围参数，但Google Apps Script的getRange()仅接受具体单元格地址（如A1、B2:D10）或已定义的命名范围名称。你既未创建名为masterSheetFormulaCell的命名范围，该字符串也不是合法单元格地址，因此触发范围不存在错误。

2. 公式拼接语法混乱
   生成FILTER公式的模板字符串存在多处语法错误：

   • 变量引用错误：模板字符串需用${变量名}而非{变量名}，比如{datarange}应改为${dataRange}
   • 工作表引用格式错误：正确格式为'SheetName'!Range，你错误写成'SheetName'$!{datarange}，多了多余的$符号
   • 括号与引号不匹配：FILTER函数的条件部分、ROW函数存在未闭合的括号，引号嵌套逻辑混乱
   • 条件逻辑偏离：原注释的筛选条件是E15:E26<>""，但拼接后的公式完全偏离该逻辑

修复后的完整代码 #

function myFunction() {
  // 配置参数
  const masterSheet = "Data";
  const ignoreSheets = ["Dashboard"];
  const dataRange = "E15:AA26";
  const checkRange = "E15:E26";
  // 公式写入的目标单元格（可根据需求修改）
  const targetCell = "A1";

  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const allSheets = ss.getSheets();
  // 过滤需要合并的工作表
  const targetSheets = allSheets.filter(sheet => !ignoreSheets.includes(sheet.getSheetName()));

  // 生成正确的FILTER公式数组
  const formulaArray = targetSheets.map(sheet => {
    const sheetName = sheet.getSheetName();
    // 筛选非空行的FILTER公式
    return `FILTER('${sheetName}'!${dataRange}, '${sheetName}'!${checkRange}<>"")`;
  });

  // 组合成数组公式
  const formulaText = `={${formulaArray.join(";")}}`;

  // 写入公式到目标单元格
  ss.getSheetByName(masterSheet).getRange(targetCell).setFormula(formulaText);
}

进阶优化建议 #

• 添加来源标识：如果需要标注每行数据的来源工作表，可修改FILTER公式部分：

  return `FILTER({'${sheetName}'!${dataRange}, "${sheetName} - ROW "&ROW('${sheetName}'!${checkRange})}, '${sheetName}'!${checkRange}<>"")`;
  

  这样会在每行数据末尾追加类似Workout1 - ROW 15的来源标识
• 增加错误处理：避免因工作表不存在导致的异常，可添加判断：

  const master = ss.getSheetByName(masterSheet);
  if (!master) {
    throw new Error(`工作表 ${masterSheet} 不存在`);
  }
  

• 动态调整范围：如果数据行不固定，可改用getDataRange()获取工作表的实际数据范围，避免硬编码范围导致遗漏数据

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