如何在Google Sheets工作簿中添加多个Apps Script函数

一、解决函数被覆盖的问题 #

你遇到的函数被覆盖，本质是操作错误——你替换了脚本编辑器里的全部代码，而非在现有代码下方追加新函数。Apps Script允许在同一个脚本文件中存放多个独立函数，或拆分到不同脚本文件中，只要不删除原有代码，函数就不会互相覆盖。

二、添加多个函数的两种方式 #

1. 在单个脚本文件中追加函数

打开Google Sheets的脚本编辑器（路径：工具→脚本编辑器），直接在已有代码后面写新函数即可，示例：

// 已有的AddColumn函数
function AddColumn() {
  // 注：原代码给所有工作表加列，是因为用了getSheets()遍历所有表，后面会说怎么改
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = ss.getSheets();
  sheets.forEach(sheet => {
    sheet.insertColumnAfter(sheet.getLastColumn());
  });
}

// 新增的MainSheet函数
function MainSheet() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const mainSheet = ss.getSheetByName("主表");
  // 这里写你的主表处理逻辑，比如设置表头
  mainSheet.getRange("A1").setValue("ID");
}

2. 拆分到多个脚本文件（适合函数较多的场景）

如果函数数量多，可按功能拆分到不同文件管理：

• 在脚本编辑器左侧文件列表，点击「+」→「脚本文件」
• 给新文件命名（比如MainSheetTools.gs），然后在该文件中编写MainSheet函数
• 原有AddColumn函数保留在Code.gs或其他文件中
• Apps Script会自动合并所有脚本文件的函数，均可直接调用

三、修复AddColumn只给单个工作表加列的问题 #

原函数给所有工作表加列，是因为用了ss.getSheets()遍历全部工作表。要仅操作指定工作表，修改代码如下：

function AddColumn() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // 替换成你需要操作的工作表名称
  const targetSheet = ss.getSheetByName("你的目标工作表");
  if (targetSheet) { // 先判断表是否存在，避免报错
    targetSheet.insertColumnAfter(targetSheet.getLastColumn());
  } else {
    SpreadsheetApp.getUi().alert("未找到目标工作表！");
  }
}

四、快速调用多个函数的技巧 #

可以给函数添加自定义菜单，在Sheets界面直接点击调用：

// 打开工作簿时自动生成自定义菜单
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu("自定义工具")
    .addItem("给目标表加列", "AddColumn")
    .addItem("处理主表", "MainSheet")
    .addToUi();
}

保存代码后刷新Sheets，顶部会出现「自定义工具」菜单，点击即可执行对应函数。

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