Google Sheets扫雷App Script：选中单元格变量不更新问题求助

我正在为Google Sheets开发扫雷App Script，需要获取选中的单元格并高亮，但highlightSelectedCell函数无法更新选中的单元格变量，每次运行都会修改同一个单元格的背景色。相关代码如下：

function highlightSelectedCell() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var selectedRange = sheet.getActiveRange();
  // var selectedCellAddress = selectedRange.getA1Notation();
  
  // Clear previous formatting
  var range = sheet.getDataRange();
  range.setBackground(null);
  
  // Highlight selected cell
  if (selectedRange.getNumRows() == 1 && selectedRange.getNumColumns() == 1) {
    selectedRange.setBackground("#0000FF");
  }
}

function sweeper() {
  let ss = SpreadsheetApp.getActive();
  let game = ss.getSheets()[0];
  let isMine = ss.getSheets()[1];
  let numberOfNearMines = ss.getSheets()[2];
  let mines = randInt(15,20);
  let statusBox = game.getRange(1,14);
  let gameBoard = game.getRange("gameBoard");

  isMine.getRange(1,1).setValue(mines);
  isMine.getRange(2,2,11,11).setValue(" ");
  statusBox.setValue("Loading...");

  for (var counter = 0; counter < mines; counter = counter + 1) {
    placeMine();
  }

  statusBox.setValue("Loaded");

  for(var counter = 0; counter>-1; counter = counter + 1) {
    gameLoop();
  }
}

function randInt(min, max) {
  return Math.floor(Math.random() * (max - min + 1)) + min
}

function placeMine() {
  let ss = SpreadsheetApp.getActive();
  let isMine = ss.getSheets()[1];
  let cell = isMine.getRange(randInt(2,11),randInt(2,11));
  if(cell.getValue() == "M") {
    placeMine();
    return
  }
  cell.setValue("M");
}

function gameLoop() {
  let ss = SpreadsheetApp.getActive();
  let game = ss.getSheets()[0];
  let isMine = ss.getSheets()[1];
  let statusBox = game.getRange(1, 14);
  let gameBoard = game.getRange("gameBoard");

  highlightSelectedCell();
  return
}

核心问题出在sweeper函数里的无限同步循环：

for(var counter = 0; counter>-1; counter = counter + 1) {
  gameLoop();
}

Google Apps Script是单线程执行的，这个无限循环会一直占着执行线程，导致：

• 脚本启动时获取的ActiveRange是固定值，之后用户切换选中单元格，脚本根本没机会重新读取最新的选中状态
• 同步循环会阻塞所有后续状态更新，包括单元格选中状态的变化传递

另外，highlightSelectedCell里每次调用getDataRange().setBackground(null)会清除整个数据区域的背景，不仅效率低，还会误改其他单元格的格式。

1. 用onSelectionChange触发器监听选中变化 #

Google Sheets提供了onSelectionChange简单触发器，用户切换选中单元格时会自动触发，完全替代手动循环调用的逻辑。

2. 优化高亮逻辑，只清除上次高亮的单元格 #

用全局变量记录上次高亮的单元格，避免每次清除整个数据区域的背景。

修改后的完整代码：

// 全局变量记录上次高亮的单元格
let lastHighlightedCell = null;

function onSelectionChange(e) {
  const sheet = e.source.getActiveSheet();
  // 只在游戏工作表（索引0）触发高亮，根据你的实际表名调整也可以
  if (sheet.getIndex() !== 0) return;
  
  const selectedRange = e.range;
  
  // 清除上次高亮的单元格
  if (lastHighlightedCell) {
    lastHighlightedCell.setBackground(null);
  }
  
  // 只高亮单个选中的单元格
  if (selectedRange.getNumRows() === 1 && selectedRange.getNumColumns() === 1) {
    selectedRange.setBackground("#0000FF");
    lastHighlightedCell = selectedRange;
  } else {
    lastHighlightedCell = null;
  }
}

function sweeper() {
  let ss = SpreadsheetApp.getActive();
  let game = ss.getSheets()[0];
  let isMine = ss.getSheets()[1];
  let numberOfNearMines = ss.getSheets()[2];
  let mines = randInt(15,20);
  let statusBox = game.getRange(1,14);
  let gameBoard = game.getRange("gameBoard");

  isMine.getRange(1,1).setValue(mines);
  isMine.getRange(2,2,11,11).setValue(" ");
  statusBox.setValue("Loading...");

  for (var counter = 0; counter < mines; counter = counter + 1) {
    placeMine();
  }

  statusBox.setValue("Loaded");
  
  // 移除原来的无限循环，交给onSelectionChange处理选中高亮
}

function randInt(min, max) {
  return Math.floor(Math.random() * (max - min + 1)) + min
}

function placeMine() {
  let ss = SpreadsheetApp.getActive();
  let isMine = ss.getSheets()[1];
  let cell = isMine.getRange(randInt(2,11),randInt(2,11));
  if(cell.getValue() === "M") {
    placeMine();
    return
  }
  cell.setValue("M");
}

关键修改说明 #

• 删掉sweeper里的无限循环，改用onSelectionChange自动监听选中变化
• 用lastHighlightedCell记录上次高亮的单元格，避免全表清除背景，提升效率
• 通过触发器事件对象e.range获取最新选中范围，确保每次都是用户当前选中的单元格
• 增加工作表判断，只在游戏工作表触发高亮，不影响其他表的操作

• onSelectionChange是简单触发器，不用手动创建，函数名正确的话Google Sheets会自动识别
• 如果需要只在游戏进行中触发高亮，可以加个全局变量记录游戏状态，在onSelectionChange里判断

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