Google 表格宏

在 Google 表格中,您可以记录用来复制您定义的一系列特定界面交互的。录制宏后,您可将其与 Ctrl+Alt+Shift+Number 形式的键盘快捷键关联。您可以使用该快捷键再次快速执行精确的宏步骤,通常在其他位置或针对不同的数据执行。您也可以从 Google 表格的扩展程序 > 菜单中激活此宏。

当您录制宏时,Google 表格会自动创建一个 Apps 脚本函数(即宏函数),用来复制宏步骤。该宏函数会添加到绑定到工作表的 Apps 脚本项目(位于标题为 macros.gs 的文件中)。如果工作表中已有项目文件绑定到该名称,则系统会向其附加宏函数。Google 表格还会自动更新脚本项目清单,记录分配给该宏的名称和键盘快捷键。

由于录制的每个宏都完全在 Apps 脚本中定义,因此您可以直接在 Apps 脚本编辑器中修改这些宏。您甚至可以在 Apps 脚本中从头开始编写宏,或者将您已经编写的函数转换为宏。

在 Apps 脚本中创建宏

您可以接受使用 Apps 脚本编写的函数并将其用作宏函数。最简单的方法是从 Google 表格编辑器导入现有函数

或者,您也可以按照以下步骤在 Apps 脚本编辑器中创建宏:

  1. 在 Google 表格界面中,依次选择扩展程序 > Apps 脚本,以在 Apps 脚本编辑器中打开绑定到该表格的脚本。
  2. 编写宏函数。宏函数不应接受任何参数,也不返回任何值。
  3. 修改脚本清单以创建宏并将其与宏函数相关联。为其分配唯一的键盘快捷键和名称。
  4. 保存脚本项目。然后,您就可以在工作表中使用该宏了。
  5. 在工作表中测试宏函数,以验证宏函数是否按预期运行。

修改宏

您可以通过执行以下操作来修改附加到工作表的宏:

  1. 在 Google 表格界面中,依次选择扩展程序 > > 管理宏
  2. 找到您要修改的宏,然后依次选择 > 修改宏。系统随即会打开 Apps 脚本编辑器,并转到包含该宏函数的项目文件。
  3. 修改宏函数可更改宏的行为。
  4. 保存脚本项目。然后,您就可以在工作表中使用该宏了。
  5. 在工作表中测试宏函数,以验证宏函数是否按预期运行。

将函数作为宏导入

如果已经有脚本绑定到某个工作表,您可以在脚本中将函数作为新宏import,然后为其分配键盘快捷键。为此,您可以修改清单文件,并向 sheets.macros[] 属性添加其他元素。

或者,您也可以按照以下步骤从 Google 表格界面中将函数作为宏导入:

  1. 在 Google 表格界面中,依次选择扩展程序 > > 导入
  2. 从显示的列表中选择一个函数,然后点击添加函数
  3. 选择 以关闭对话框。
  4. 依次选择扩展程序 > > 管理宏
  5. 在列表中找到您刚刚导入的函数。请为此宏指定一个独一无二的键盘快捷键。您也可以在此更改宏的名称;名称默认为函数的名称。
  6. 点击更新以保存宏配置。

宏的清单结构

以下清单文件示例代码段显示了清单中定义 Google 表格宏的部分。清单的 sheets 部分定义了分配给宏的名称和键盘快捷键以及宏函数的名称。

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

如需详细了解如何构建 Google 表格宏清单,请参阅 Google 表格宏清单资源

最佳实践

使用 Apps 脚本创建或管理宏时,建议您遵循以下准则。

  1. 轻量级宏的性能更高。请尽可能限制宏执行的操作数量。
  2. 宏最适合需要频繁重复且几乎没有配置的情况的循环操作。对于其他操作,请考虑改用自定义菜单项
  3. 请务必注意,宏键盘快捷键必须是唯一的,并且给定工作表一次最多只能包含十个带快捷键的宏。所有其他宏只能通过扩展 > 菜单执行。
  4. 您可以将更改单个单元格的宏应用于一系列单元格,方法是先选择整个范围,然后再激活宏。这意味着通常不需要创建在预定义的单元格范围内复制相同操作的宏。

禁止事项

关于使用宏执行的操作,存在一些限制:

在绑定脚本之外使用宏

宏是在绑定到特定 Google 表格的脚本中定义的。如果在独立脚本Web 应用中定义宏定义,则系统会忽略宏定义。

在 Google 表格插件中定义宏

您无法使用表格插件分发宏定义。Google 表格插件项目中的所有宏定义都会被该插件的用户忽略。

在脚本库中分发宏

您无法使用 Apps 脚本分发宏定义。

在 Google 表格之外使用宏

宏仅是 Google 表格中的功能,Google 文档、表单或幻灯片中不存在宏。