注意
本文假设你熟悉 初始化 Office 加载项。
调试 Office.initialize 和 Office.onReady 函数的自相矛盾在于，调试器只能附加到正在运行的进程，但这些函数在加载项的运行时进程启动时会立即运行，然后调试器才能附加。 在大多数情况下，在附加调试器后重启加载项无济于事，因为重启加载项会关闭原始运行时进程 和附加的调试器 ，并启动未附加调试器的新进程。
幸运的是，有两种方法可以调试以下部分所述的这些函数。
使用 Office web 版 进行调试
若要使用 Office web 版 进行调试，请使用以下步骤。
- 在 Office web 版 中旁加载并运行加载项。 这通常是通过打开加载项的任务窗格或运行 函数命令来完成的。 外接程序在整个浏览器进程中运行，而不是像在桌面 Office 中那样单独运行。
- 打开浏览器的开发人员工具。 这通常通过按 F12 来完成。 工具中的调试器附加到浏览器进程。
- 根据需要将断点应用于 或
Office.onReady函数中的Office.initialize代码。 - 像在步骤 1 中一样，重新启动加载项的任务窗格或函数命令。 此作 不会 关闭浏览器进程或调试器。
Office.initialize或Office.onReady函数再次运行，并在断点上停止处理。
提示
有关详细信息，请参阅调试 Office web 版 中的加载项。
在 Windows 上使用 Office 进行调试
注意
仅当使用 WebView2 Webview 控件的加载项时，本节中所述的技术才有效。 若要确定你正在使用的 Web 视图，请参阅 Office 外接程序使用的浏览器和 Webview 控件。
提示
在 Office 的最新版本中，标识 Office 正在使用的 Web 视图控件的一种方法是通过任何加载项上的 个性菜单 （如果有）。 (Outlook 中不支持“个性”菜单。) 打开菜单并选择“ 安全信息”。 在 Windows 上的“安全信息”对话框中，运行时报告Microsoft Edge、Microsoft Edge 旧版或 Internet Explorer。 旧版 Office 中的对话框中不包含运行时。
若要调试加载项的初始化顺序，请配置环境，以便在外接程序启动时自动打开Microsoft基于 WebView2 (Chromium 的) 开发人员工具。
- 关闭计划调试加载项的 Office 应用程序。
- 将
WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS环境变量设置为包含值--auto-open-devtools-for-tabs。 - 打开 Office 应用程序。
- 运行加载项。
- 应自动打开基于 (Chromium Microsoft Edge) 开发人员工具。 使用工具与调试任务窗格时相同，如使用基于 Microsoft Edge (Chromium (Chromium) 开发人员工具调试任务窗格加载项中所述。
注意
你可能会看到自动打开的基于 Microsoft Edge (Chromium) 开发人员工具的其他实例，因为此环境变量会影响系统中的所有 WebView2 实例。