如何在Google Sheets脚本中实现Ctrl+Home的定位效果？

以下是可直接复用的脚本，能自动定位到过滤或未过滤状态下表格的可见最上方行第一个单元格：

function jumpToTopVisibleCell() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange();
  const totalRows = dataRange.getNumRows();
  
  // 遍历找到第一个未被过滤隐藏的行
  let firstVisibleRow = 1;
  for (let row = 1; row <= totalRows; row++) {
    if (!sheet.isRowHiddenByFilter(row)) {
      firstVisibleRow = row;
      break;
    }
  }
  
  // 激活目标单元格
  sheet.getRange(firstVisibleRow, 1).activate();
}

关键逻辑说明 #

• sheet.isRowHiddenByFilter(row) 是适配过滤状态的核心，用来判断某一行是否被过滤规则隐藏
• 从第一行开始遍历，找到第一个可见行后立即停止，保证执行效率
• 激活该行的第一列单元格，效果和手动按Ctrl+Home完全一致

自定义调整 #

如果表格有固定表头（比如表头在第1行，实际数据从第2行开始），可修改遍历起始行：

// 将遍历起始行从1改为2
for (let row = 2; row <= totalRows; row++) {

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