在 Mac 上调试 Office 加载项

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

重要

仅当 Office 从 Office.com 而不是 Apple App Store 安装到 Mac 上时，才能使用 Office 调试加载项。

在 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

  重要

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

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

注意

• 如果要在 Outlook on Mac 中调试基于事件或垃圾邮件报告的外接程序，请在配置 OfficeWebAddinDeveloperExtras 属性后按照调试基于事件的或垃圾邮件报告的 Outlook 外接程序中的步骤作。

• 如果你尝试使用检查器时对话框闪烁，请将 Office 更新到最新版本。 如果这无法解决闪烁问题，请尝试以下解决方法。

  1. 缩小对话框大小。
  2. 选择“检查元素”，这将在新窗口中打开。
  3. 将对话框调整为原始大小。
  4. 根据需要使用检查器。

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

出于性能原因，加载项通常缓存在 Office on Mac 中。 有关如何在 Mac 上清除 Office 缓存的指南，请参阅 清除 Mac 上的 Office 缓存。