确定 VBA 宏是否兼容

如果宏中使用的所有 API 在 Apps 脚本中都有直接的等效项，则包含 Visual Basic for Applications (VBA) 宏的 Excel 文件被认为是兼容的。如果您的宏不完全兼容，您或许可以应用变通方法或调整代码，使其与 Apps 脚本搭配使用。

您可以使用 Macro Converter 的兼容性报告来确定是否可以直接按原样自动转换文件，或者是否需要对代码进行调整。

生成兼容性报告时，系统会将以下状态之一应用于您的每个文件和 API：

状态 定义
完全支持 这些文件包含的 API 在 Apps 脚本中都有直接的等效项。
通过变通方法支持 这些文件包含至少一个可以通过 变通方法支持的 API。
需要进一步调查 这些文件包含至少一个需要您查看的 API，以 确定后续操作。例如，可能没有等效的 API，或者 Macro Converter 可能尚未确定所使用的 API。

生成兼容性报告

  1. 在电脑上打开 Google 云端硬盘。
  2. 在右侧边栏上，点击 Macro Converter Google Workspace 插件 表示 Macro Converter 插件的图标。如果您没有看到侧边栏，请点击右下角的“显示侧边栏”图标 。
  3. 点击添加文件和文件夹 。Macro Converter 仅识别 Excel 文件。
  4. 选择要分析的文件或文件夹，然后点击选择 。每次选择的文件数量不得超过 2,000 个。
  5. 如需更改兼容性报告的保存位置，请点击“更改 目标文件夹 ”图标，然后选择所需的 文件夹。否则，报告会保存在“我的云端硬盘”文件夹中。
  6. 点击生成报告 。
  7. 分析完成后，点击查看报告 。

查看兼容性报告

您可以根据兼容性报告中的详细信息，决定如何继续进行文件转换。您的报告包含以下部分：

  • 摘要：此工作表对 所有提交的文件及其 API 的兼容性进行了汇总分析。
  • 文件 - 兼容性：此工作表列出了提交给 Macro Converter 的每个文件，以及每个文件的兼容性状态和详细信息。
  • 文件 - 详细分析：此工作表提供了有关文件中 API 的更多信息，以及您可以采取哪些措施来成功转换每个 API。首先，从顶部的下拉菜单中选择一个文件。然后，从底部的下拉菜单中选择一个状态。

如果多个文件同名，请使用文件名旁边的唯一标识符来区分它们。在云端硬盘中打开文件 ，然后在网址中查找唯一标识符： https://drive.google.com/file/d/<file_identifier>/view。

您还可以使用名为 APIs to investigate 和 APIs with workarounds 的工作表，逐个 API 查看报告。

确定后续操作

针对每种状态，我们建议您执行以下操作：

状态 建议
完全支持 VBA API 中的相同逻辑可在 Apps 脚本中复制。 继续进行转换。
通过变通方法支持 您需要编写代码，将至少一个 VBA API 替换为 等效的 Apps 脚本 API。通常，您可以继续进行 转换。

您可以在转换文件之前或之后手动替换标记为通过变通方法支持的 VBA API。我们建议您 提前进行更改 。

需要进一步调查 至少有一个 API 无法转换。根据该 API 在代码中的重要性，您可能无法转换该文件。应由了解原始 VBA 代码的人员进行最终 评估。

如果您决定转换文件，则需要编写代码，将 至少一个 VBA API 替换为 Apps 脚本。在转换文件之前或之后手动替换标记为需要调查的 VBA API。我们建议您提前进行更改。

评估兼容性报告后，请参阅将 VBA 宏转换为 Apps 脚本。