如何在访问Google Sheets特定工作表标签时触发代码执行？

Google Apps Script没有原生的工作表标签切换触发器，不过可以通过两种方式实现需求：

方法一：利用onSelectionChange触发器（简单易实现） #

切换工作表时，选区会自动切换到目标表的单元格，因此可以借助onSelectionChange触发器判断当前活动工作表是否为目标表，匹配则执行代码。

1. 打开Google Sheets的脚本编辑器（顶部菜单「工具」→「脚本编辑器」）
2. 写入以下代码：

function checkAndRun(e) {
  // 替换成你要监听的工作表标签名
  const targetSheet = "目标工作表名称";
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  
  if (activeSheet.getName() === targetSheet) {
    // 这里写你要执行的业务代码
    Logger.log(`已切换到${targetSheet}，执行指定代码`);
    // 示例：弹出提示框
    SpreadsheetApp.getUi().alert(`欢迎访问${targetSheet}工作表`);
  }
}

3. 创建可安装触发器：
   • 点击左侧「触发器」图标（时钟样式）
   • 点击「添加触发器」，配置如下：
     • 运行函数：checkAndRun
     • 事件源：「从电子表格」
     • 事件类型：「当更改选区时」
   • 保存并完成权限授权

注：简单触发器的onSelectionChange可能存在触发限制，推荐使用可安装触发器确保稳定性。

方法二：客户端脚本监听（精准触发，仅切换标签时执行） #

如果不想因单元格选区变化误触发，可通过侧边栏的客户端脚本定时检查工作表切换状态，仅在标签切换时执行代码。

1. 在脚本编辑器中创建两个文件：

   • 服务器端脚本：Code.gs
   • 客户端HTML：Sidebar.html

2. Code.gs代码：

// 打开监听侧边栏
function autoShowSidebar() {
  const html = HtmlService.createHtmlOutputFromFile('Sidebar').setTitle('工作表监听');
  SpreadsheetApp.getUi().showSidebar(html);
}

// 你要执行的目标代码
function executeOnSheetSwitch() {
  const targetSheet = "目标工作表名称";
  const activeSheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  if (activeSheet.getName() === targetSheet) {
    // 示例：更新单元格内容
    activeSheet.getRange("A1").setValue(`最后访问时间：${new Date().toLocaleString()}`);
  }
}

// 获取当前活动工作表名称
function getCurrentSheetName() {
  return SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getName();
}

3. Sidebar.html代码：

<!DOCTYPE html>
<html>
  <body>
    <script>
      let currentSheet;
      
      // 初始化获取当前工作表
      google.script.run.withSuccessHandler(name => {
        currentSheet = name;
      }).getCurrentSheetName();
      
      // 每秒检查一次工作表状态
      setInterval(() => {
        google.script.run.withSuccessHandler(newSheet => {
          if (newSheet !== currentSheet) {
            currentSheet = newSheet;
            // 切换标签时调用服务端代码
            google.script.run.executeOnSheetSwitch();
          }
        }).getCurrentSheetName();
      }, 1000);
    </script>
  </body>
</html>

4. 配置自动打开侧边栏：
   • 创建可安装的onOpen触发器，绑定autoShowSidebar函数，这样每次打开表格时自动启动监听。

注：此方法需保持侧边栏打开，关闭后监听会停止。

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