Google 表格宏

借助 Google 表格 宏可复制 您定义的一系列特定的界面交互录制好一个音频之后 宏，那么您可以将其与以下形式的键盘快捷键相关联： Ctrl+Alt+Shift+Number。您可以使用该快捷键快速执行 精确的宏步骤，通常是在不同的位置或针对不同的数据。 您也可以在 Google 表格的扩展程序中激活宏 > 宏菜单中。

当您录制宏时，Google 表格会自动创建 Apps 脚本 函数（宏函数），用于复制宏步骤。宏 函数添加到了 Apps 脚本项目中，并且绑定了 添加到工作表（位于标题为 macros.gs 的文件中）。如果存在 已经有一个项目文件绑定到以该名称的工作表，则宏函数 。Google 表格还会自动更新脚本 项目 manifest，记录名称 和键盘快捷键。

由于录制的每个宏都完全在 Apps 脚本中定义，因此您可以 直接在 Apps 脚本编辑器中修改它们。你甚至可以编写宏 使用 Apps Script 编写代码，也可以接受您已编写好的函数， 并将其转换为宏。

在 Apps 脚本中创建宏

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

或者，您也可以在 Apps 脚本编辑器中创建宏，方法是 按以下步骤操作：

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

编辑宏

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

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

将函数作为宏导入

如果已有脚本绑定到某个工作表， 可以将脚本中的函数作为新宏导入，然后将其分配给 键盘快捷键。为此，您可以 修改清单 并将另一个元素添加到 sheets.macros[] 属性。

此外，也可以按照下述步骤，将函数作为宏从 表格界面：

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

宏的清单结构

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

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

请参阅表格的宏清单资源 ，详细了解如何构建 Google 表格的宏清单。

最佳做法

在 Apps 脚本中创建或管理宏时，建议您 请遵守以下准则。

  1. 轻量级宏的性能更佳。尽可能限制 宏所执行的操作的数量
  2. 宏最适合用于需要重复的旋转操作 通常只需少量配置甚至无需配置即可对于其他运算，请考虑 请改用自定义菜单项。
  3. 请注意，宏键盘快捷键必须是唯一的，并且指定的 工作表一次只能包含 10 个带有快捷键的宏。任何其他 只能通过扩展程序 > 宏菜单。
  4. 对单个单元格进行更改的宏可应用于 单元格，首先选择整个范围，然后激活宏。 也就是说，通常不需要创建 可以对预定义的单元格范围执行相同的操作。

禁止事项

使用宏可以执行的操作有一些限制：

在绑定脚本之外使用宏

宏是在绑定到特定 Google 表格的脚本中定义的。宏观 如果在模板中定义，则会被忽略 独立脚本或 Web 应用。

在 Google 表格插件中定义宏

您不能使用 表格插件。Google 表格中的任何宏定义 该插件的用户会忽略该插件项目。

在脚本库中分发宏

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

在 Google 表格之外使用宏

宏只是 Google 表格中的功能，Google 文档、 表单或幻灯片。