在 Mac 上调试 Office 加载项

由于加载项是使用 HTML 和 JavaScript 开发的，因此它们设计为跨平台工作，但不同浏览器呈现 HTML 的方式可能存在细微差异。 本文介绍如何调试在 Mac 上运行的加载项。

在 Mac 上使用 Safari Web 检查器进行调试

如果有在任务窗格或内容加载项中显示 UI 的加载项，可以使用 Safari Web 检查器调试 Office 加载项。

为了能够在 Mac 上调试 Office 加载项，必须具有 Mac OS High Sierra AND Mac Office 版本 16.9.1 (内部版本18012504) 或更高版本。 如果你没有 Office on Mac 版本，你可能有资格通过 Microsoft 365 开发人员 计划获得 Microsoft 365 E5 开发人员订阅;有关详细信息，请参阅 常见问题解答。 或者，可以 注册 1 个月的免费试用版 或 购买 Microsoft 365 计划。

首先，打开终端，设置相关 Office 应用程序的 OfficeWebAddinDeveloperExtras 属性，如下所示：

• defaults write com.microsoft.Word OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Excel OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Powerpoint OfficeWebAddinDeveloperExtras -bool true

• defaults write com.microsoft.Outlook OfficeWebAddinDeveloperExtras -bool true

  重要

  Office 的 Mac App Store 版本不支持 标志 OfficeWebAddinDeveloperExtras 。

然后，打开 Office 应用程序并旁加载你的加载项。 选择并按住 (或右键单击加载项) ，上下文菜单中应会显示“ 检查元素 ”选项。 选择该选项，它将弹出检查器，可以在其中设置断点并调试加载项。

在 Mac 上清除 Office 应用程序的缓存

出于性能原因，加载项通常缓存在 Office on Mac 中。 通常情况下，将通过重新加载加载项清除缓存。 如果同一文档中存在多个加载项，则重载后自动清除缓存的过程可能不可靠。

使用“个性”菜单清除缓存

可以通过使用任何任务窗格加载项的个性菜单来清除缓存。 但是，由于 Outlook 加载项不支持个性化菜单，因此，如果使用的是 Outlook，可以尝试手动 清除缓存 的选项。

• 选择个性菜单。 然后选择“清除 Web 缓存”。

  注意

  必须运行 macOS 版本 10.13.6 或更高版本才能看到个性菜单。

  

手动清除缓存

还可以通过删除 和 ~/Library/Containers/com.microsoft.{host}/Data/Documents/wef 文件夹的内容~/Library/Containers/com.Microsoft.OsfWebHost/Data/来手动清除缓存。 将 替换为 {host} Office 应用程序，例如 Excel。 通过终端查找这些文件夹。

删除文件夹的内容 ~/Library/Containers/com.microsoft.{host}/Data/Documents/wef 会从应用程序的加载项菜单中删除旁加载的加载项。