在 Mac 上调试 Office 加载项

  • 项目

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

重要

仅当 Office 安装在 Mac 上的 Office.com（ 而不是 Apple 应用商店）时，才能使用 Office 在 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

    重要

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

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

注意

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

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

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

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

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

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

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

    注意

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

    个性化菜单上的清除 Web 缓存选项。

手动清除缓存

也可以通过删除 ~/Library/Containers/com.Microsoft.OsfWebHost/Data/ 文件夹中的内容来手动清除缓存。 通过终端查找此文件夹。

注意

如果该文件夹不存在，请通过终端检查以下文件夹，如果找到，请删除文件夹的内容。

  • ~/Library/Containers/com.microsoft.{host}/Data/Library/Caches/，其中，{host} 是 Office 应用程序（例如 Excel）
  • ~/Library/Containers/com.microsoft.{host}/Data/Library/Application Support/Microsoft/Office/16.0/Wef/，其中，{host} 是 Office 应用程序（例如 Excel）
  • ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Caches/com.microsoft.Office365ServiceV2/
  • ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Library/Caches/com.microsoft.Office365ServiceV2/

若要通过 Finder 查找这些文件夹，必须将 Finder 设置为显示隐藏的文件。 Finder 按产品名称显示 Containers 目录中的文件夹，例如 Microsoft Excel 而不是 com.microsoft.Excel。