如果宏中使用的所有 API 在 Apps 脚本中都有直接等效项，则包含 Visual Basic for Applications (VBA) 宏的 Excel 文件会被视为兼容。如果您的宏不完全兼容，您或许可以应用权宜解决方法或调整代码，使其与 Apps Script 搭配使用。
使用宏转换工具的兼容性报告，确定您能否按原样自动转换文件，还是需要调整代码。
生成兼容性报告时，系统会对您的每个文件和 API 应用以下某种状态：
| 状态 | 定义 |
|---|---|
| 完全受支持 | 这些文件包含的 API 在 Apps 脚本中都有直接等效项。 |
| 支持，但需要使用权宜解决方法 | 这些文件包含至少 1 个可通过权宜解决方法支持的 API。 |
| 需要进一步调查 | 这些文件包含至少一个您需要审核的 API，以便确定后续步骤。例如，可能没有等效的 API，或者宏转换器可能未确定使用的 API。 |
生成兼容性报告
- 在计算机上打开 Google 云端硬盘。
- 在右侧面板中，点击“宏转换器”插件
。如果您没有看到侧边栏，请点击右下角的“显示侧边栏”图标 。 - 点击添加文件和文件夹。宏转换器仅识别 Excel 文件。
- 选择要分析的文件或文件夹，然后点击选择。一次选择的文件数量不得超过 2,000 个。
- 如需更改兼容性报告的保存位置，请点击“更改目标文件夹”图标 ，然后选择所需的文件夹。否则，系统会将其保存在“我的云端硬盘”文件夹中。
- 点击生成报告。
- 分析完成后，点击查看报告。
查看兼容性报告
您可以参考兼容性报告中的详细信息，决定如何继续进行文件转换。您的报告包含以下部分：
- 摘要：此工作表汇总分析了所有已提交文件及其 API 的兼容性。
- 文件 - 兼容性：此工作表列出了提交到宏转换器的每个文件，以及每个文件的兼容性状态和详细信息。
文件 - 详细分析：此工作表详细介绍了文件中的 API，以及您可以执行哪些操作来成功转换每个 API。首先，从顶部的下拉菜单中选择一个文件。然后，从底部的下拉菜单中选择状态。
您还可以使用名为需要调查的 API 和有权宜解决方法的 API 的电子表格，逐个 API 查看报告。
确定后续步骤
以下是我们针对每种状态的建议做法：
| 状态 | 建议 |
|---|---|
| 完全受支持 | 您可以在 Apps Script 中复制 VBA API 中的相同逻辑。 继续转换。 |
| 支持，但需要使用权宜解决方法 | 您需要编写代码，将至少一个 VBA API 替换为等效的 Apps 脚本 API。通常，您可以继续转换。
您可以在转换文件之前或之后，手动替换标记为支持权宜解决方法的 VBA API。我们建议您提前进行更改。 |
| 需要进一步调查 | 至少有一个 API 无法转换。根据该 API 在代码中的重要性，您可能无法转换该文件。
熟悉原始 VBA 代码的人员应进行最终评估。
如果您决定转换文件，则需要编写代码，将至少一个 VBA API 替换为 Google Apps 脚本。您可以在转换文件之前或之后手动替换标记为需要调查的 VBA API。我们建议您提前进行更改。 |
评估兼容性报告后，请参阅将 VBA 宏转换为 Apps Script。