Office JS共享运行时日志与堆栈跟踪位置排查

问题核心原因 #

共享JS运行时的执行上下文独立于普通网页，它运行在Office客户端内置的隐藏WebView中，并非直接关联你打开的浏览器开发者工具，因此常规控制台无法捕获日志。

分场景查看方法 #

1. Script Lab环境 #

• 直接查看Script Lab内置控制台：在Script Lab界面右侧，找到「Console」标签页（与「Code」「Run」标签并列），console.log的输出会直接显示在这里。
• 桌面版Office客户端调试：
  • 按F12打开Office内置开发者工具（部分版本需先在Office选项中启用「开发者模式」）
  • 切换到工具的「Console」标签，即可看到共享运行时的日志输出

2. Yeoman Yo Office脚手架项目 #

• 桌面版Office：
  • 启用开发者模式：打开Office应用（如Excel/Word）→ 文件 → 选项 → 自定义功能区 → 勾选「开发工具」选项卡 → 确定
  • 点击「开发工具」选项卡 → 加载插件后，点击「Developer Tools」按钮打开内置调试工具，日志会出现在Console面板中
• 网页版Office：
  • 打开浏览器开发者工具（F12或Ctrl+Shift+I）
  • 在「Console」面板的上下文切换菜单中，选择对应插件的iframe（名称通常包含插件ID），即可查看日志

配置验证与额外技巧 #

• 确认manifest.xml中SharedRuntime 1.1配置正确：

  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Hosts>
      <Host xsi:type="Workbook">
        <Runtimes>
          <Runtime resid="Contoso.Taskpane.Url" lifetime="long" />
        </Runtimes>
      </Host>
    </Hosts>
  </VersionOverrides>
  

• 若日志仍无法捕获，可通过Office.context.ui.displayDialogAsync弹出对话框，在对话框脚本中输出日志，对话框的开发者工具能直接捕获这些内容

内容的提问来源于stack exchange，提问作者Georg Heiler