在 Office 网页版中调试加载项

  • 项目

本文介绍如何使用 Office web 版 调试加载项。使用此技术：

  • 在未运行 Windows 或 Office 桌面客户端的计算机上调试加载项，例如，如果你是在 Mac 或 Linux 上进行开发。
  • 如果不能或不希望在 IDE 中调试（如 Visual Studio 或 Visual Studio Code），则作为替代调试过程。

本文假定你有一个需要调试的外接程序项目。 如果只想在 Web 上练习调试，请使用特定 Office 应用程序的快速入门之一创建新项目，例如本Word快速入门。

调试加载项

若要使用 Office 网页版调试加载项，请执行以下操作：

  1. 在 localhost 上运行项目，并将其旁加载到 Office web 版 中的文档。 有关详细的旁加载说明，请参阅 在 Web 上手动旁加载 Office 加载项。

  2. 打开浏览器的开发人员工具。 这通常通过按 F12 来完成。 打开调试器工具并使用它设置断点和watch变量。 有关使用浏览器工具的详细帮助，请参阅以下其中一项：

    注意

    • Office web 版无法在 Internet Explorer 中打开。
    • 新的 Outlook on Window 桌面客户端 (预览) 不支持上下文菜单或键盘快捷方式来访问 Microsoft Edge 开发人员工具。 相反，必须从命令提示符运行 olk.exe --devtools 。 有关详细信息，请参阅 为新的 Windows 版 Outlook 开发 Outlook 加载项 的“调试加载项”部分， (预览版) 。

潜在问题

下面是在调试时可能会遇到的一些问题。

  • 你看到的一些 JavaScript 错误可能源自 Office 网页版。
  • 浏览器可能会显示需要绕过的无效证书错误。 执行此操作的过程因浏览器而异，而且用于执行此操作的各种浏览器的 UI 会定期进行更改。 有关说明，可搜索浏览器的“帮助”或“联机搜索”。 （例如，搜索“Microsoft Edge 无效证书警告”。）大多数浏览器在“警告”页面上都有一个链接，可以通过此链接单击进入“加载项”页。 例如，Microsoft Edge 具有“转到网页 (不建议) ”链接。 但每次加载项重新加载时，你通常必须通过此链接。 如需更长久地忽略，请参阅建议的帮助。
  • 如果在代码中设置了断点，Office web 版可能会引发指示无法保存的错误。

另请参阅