求编写Google Apps Script函数定位指定行首空列

核心函数：定位指定行的首个空列 #

以下函数可直接传入工作表对象和行号，返回该行第一个空单元格的列号，适配你的横向数据存储场景：

function getFirstEmptyColumnInRowFromI(sheet, rowNumber) {
  // 限定查找范围为I列（第9列）到AW列（第49列），对应你的商品数据区域
  const startCol = 9;
  const endCol = 49;
  const rowData = sheet.getRange(rowNumber, startCol, 1, endCol - startCol + 1).getValues()[0];
  
  // 遍历行数据，找到第一个空值的位置
  for (let colIndex = 0; colIndex < rowData.length; colIndex++) {
    if (rowData[colIndex] === "") {
      // 转换为实际列号
      return startCol + colIndex;
    }
  }
  
  // 若区域内无空列，返回下一列
  return endCol + 1;
}

根据姓名/竞拍者编号查找客户行 #

结合慈善拍卖的实际需求，先实现通过标识符定位客户所在行的函数：

function findCustomerRow(sheet, identifierType, identifierValue) {
  // 假设A列存竞拍者编号，B列存姓名，可根据实际结构调整
  const searchCol = identifierType === "编号" ? 1 : 2;
  const allIdentifiers = sheet.getRange(2, searchCol, sheet.getLastRow() - 1).getValues();
  
  // 从第2行开始遍历（第1行为表头）
  for (let rowIndex = 0; rowIndex < allIdentifiers.length; rowIndex++) {
    if (allIdentifiers[rowIndex][0] === identifierValue) {
      // 返回实际行号
      return rowIndex + 2;
    }
  }
  
  // 未匹配到客户时返回null
  return null;
}

完整整合：添加商品购买记录 #

将上述两个函数结合，实现「找客户→定位空列→写入商品和价格」的完整流程：

function addPurchaseRecord(customerIdentifierType, customerIdentifier, productDesc, price) {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("你的工作表名称"); // 替换为实际表名
  
  // 1. 查找客户所在行
  const customerRow = findCustomerRow(sheet, customerIdentifierType, customerIdentifier);
  if (!customerRow) {
    console.log("未找到该客户");
    return;
  }
  
  // 2. 定位该行首个空列
  const firstEmptyCol = getFirstEmptyColumnInRowFromI(sheet, customerRow);
  
  // 3. 写入商品描述和价格（保证列对结构：商品列后紧跟价格列）
  sheet.getRange(customerRow, firstEmptyCol).setValue(productDesc);
  sheet.getRange(customerRow, firstEmptyCol + 1).setValue(price);
  
  console.log("购买记录已成功添加");
}

关于公式转脚本的说明 #

你提到的公式=INDEX(a4:ArrayFormula(Max(COLUMN(A4:4)*(--(A4:4)<>""))))是用于查找最后一个非空列，转成脚本的实现如下（但不符合你的「找首个空列」需求，仅作参考）：

function getLastFilledColumnInRow(sheet, rowNumber) {
  const rowData = sheet.getRange(rowNumber, 1, 1, sheet.getLastColumn()).getValues()[0];
  const filledColumns = rowData.map((val, idx) => val !== "" ? idx + 1 : 0).filter(num => num > 0);
  return filledColumns.length > 0 ? Math.max(...filledColumns) : 0;
}

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