如何使用textfinder()获取同行其他列的对应值？

算力阿峰

2026-8-11

修改代码获取用户邮箱的方法

你之前报错是因为getRowIndex()返回的是纯数字行号，数字类型没有getValues()方法——得先拿到匹配的单元格对象，再基于它提取目标列的值。

两种修改方案：

方案1：获取整行数据再提取邮箱（适合需要多列数据的场景）

var ss = SpreadsheetApp.openByUrl(url);
var thisSheet = ss.getSheetByName("users");
var tf = thisSheet.createTextFinder("user1");
var foundCell = tf.findNext(); // 获取匹配的单元格对象

// 先判断是否找到用户，避免空值报错
if (foundCell) {
  var rowNum = foundCell.getRow();
  // 获取整行数据：从rowNum行第1列开始，取1行，列数到表格最后一列
  var rowData = thisSheet.getRange(rowNum, 1, 1, thisSheet.getLastColumn()).getValues()[0];
  // 假设邮箱在第2列（Google Sheets列从1开始，数组索引从0开始，所以用1）
  var userEmail = rowData[1];
  return userEmail;
} else {
  return "未找到匹配用户";
}

方案2：直接获取目标列的值（更高效，适合只需要邮箱的场景）

如果知道邮箱固定在某一列（比如B列，对应列号2），可以直接定位到该单元格取值：

var ss = SpreadsheetApp.openByUrl(url);
var thisSheet = ss.getSheetByName("users");
var tf = thisSheet.createTextFinder("user1");
var foundCell = tf.findNext();

if (foundCell) {
  // 直接获取匹配行的第2列（邮箱列）的值
  var userEmail = thisSheet.getRange(foundCell.getRow(), 2).getValue();
  return userEmail;
} else {
  return "未找到匹配用户";
}