Google Script获取工作表指定行最后非空列的方法

原有代码失效原因 #

Range对象的getLastColumn()方法返回的是所选范围自身的右边界列索引，不会判断范围内单元格是否存在内容，因此选中1-30列的单行范围时，无论中间单元格是否为空，调用该方法都会固定返回30。
而Sheet对象的全局getLastColumn()方法返回的是整个工作表所有行里有内容的最大列号，如果后续在其他行的更右列填充内容，这个返回值就会偏离第一行的真实结果，无法满足需求。

可用代码 #

function getFirstRowLastNonEmptyCol() {
  const sheet = SpreadsheetApp.getActive().getActiveSheet();
  // 拉取第一行全列的数值，仅读取1行数据，性能开销可忽略
  const firstRowValues = sheet.getRange(1, 1, 1, sheet.getMaxColumns()).getValues()[0];
  
  let lastNonEmptyCol = 0;
  // 从最右侧列向左遍历，找到第一个非空单元格即终止，遍历效率最高
  for (let colIndex = firstRowValues.length - 1; colIndex >= 0; colIndex--) {
    const cellValue = firstRowValues[colIndex];
    if (cellValue !== null && cellValue !== "") {
      lastNonEmptyCol = colIndex + 1; // 数组索引从0计数，表格列号从1计数，做偏移修正
      break;
    }
  }

  Logger.log(lastNonEmptyCol); // 对应你的场景会正确返回16
  return lastNonEmptyCol;
}

方案特性 #

• 无需硬编码最大列数：通过sheet.getMaxColumns()自动获取工作表当前总列数，适配工作表后续的列数调整
• 不受其他行内容干扰：仅读取第一行的数值做判断，后续在Q2、Q3、Q4等其他行单元格填充内容，完全不会影响第一行的计算结果
• 执行效率高：从右往左遍历遇到第一个非空值就停止，不需要遍历整行所有单元格，即使工作表有上千列也能快速返回结果
• 空值判断准确：会自动跳过完全无内容的空单元格、以及返回空字符串的公式单元格

注意：不要尝试用Range类的getLastColumn()方法做非空判断，这个方法的设计逻辑就是返回范围边界，和单元格内容无关。

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