Office Word Add-in任务窗格无法加载问题求助

问题描述 #

Word加载项的触发按钮正常显示在“AddIns”选项卡下，但点击后无法打开任务窗格，Word底部却提示“Add-ins loaded successfully”。

相关manifest.xml代码片段 #

<Hosts>
  <Host xsi:type="Document">
    <!-- Read DesktopFormFactor: https://learn.microsoft.com/en-us/javascript/api/manifest/desktopformfactor?view=common-js-preview -->
    <DesktopFormFactor>

      <!-- The OfficeTab with id="TabAddins" isn't needed for the Add-ins tab, as PrimaryCommandSurface will place the button in the "Add-ins" tab automatically. -->
      <ExtensionPoint xsi:type="PrimaryCommandSurface">
        <Control xsi:type="Button" id="yyyqqq.Button">
          <Label resid="TaskpaneButton.Title"/>
          <Supertip>
            <Title resid="TaskpaneButton.Title"/>
            <Description resid="TaskpaneButton.Tooltip"/>
          </Supertip>
          <Icon>
            <bt:Image size="16" resid="Icon.16x16"/>
            <bt:Image size="32" resid="Icon.32x32"/>
            <bt:Image size="80" resid="Icon.80x80"/>
          </Icon>
          <Action xsi:type="ShowTaskpane">
            <!-- <SourceLocation resid="Taskpane.Url"/> -->
            <TaskpaneId>yyyqqq</TaskpaneId>
            <SourceLocation resid="TaskPaneUrl"/>
          </Action>
        </Control>
      </ExtensionPoint>

    </DesktopFormFactor>
  </Host>
</Hosts>
<Resources>
  <bt:Images>
    <bt:Image id="Icon.16x16" DefaultValue="https://yyyqqq.com/static/wordapp/logo-16.png"/>
    <bt:Image id="Icon.32x32" DefaultValue="https://yyyqqq.com/static/wordapp/logo-32.png"/>
    <bt:Image id="Icon.64x64" DefaultValue="https://yyyqqq.com/static/wordapp/logo-64.png"/>
    <bt:Image id="Icon.80x80" DefaultValue="https://yyyqqq.com/static/wordapp/logo-80.png"/>
    <bt:Image id="Icon.128x128" DefaultValue="https://yyyqqq.com/static/wordapp/logo-128.png"/>
    <bt:Image id="Icon.150x150" DefaultValue="https://yyyqqq.com/static/wordapp/logo-150.png"/>
  </bt:Images>
  <bt:Urls>
    <bt:Url id="GetStarted.LearnMoreUrl" DefaultValue="https://go.microsoft.com/fwlink/?LinkId=276812"/>
    <bt:Url id="TaskPaneUrl" DefaultValue="https://yyyqqq.com/wordapp/login"/>
  </bt:Urls>
  <bt:ShortStrings>
    <bt:String id="GetStarted.Title" DefaultValue="Get started with your sample add-in!"/>

    <bt:String id="yyyqqq.TabLabel" DefaultValue="yyyqqq"/>
    <bt:String id="yyyqqq.GroupLabel" DefaultValue="AI Tools"/>
    <bt:String id="TaskpaneButton.Title" DefaultValue="bla!"/>
    <bt:String id="TaskpaneButton.Tooltip" DefaultValue="bla2!"/>
  </bt:ShortStrings>
  <bt:LongStrings>
     <bt:String id="GetStarted.Description" DefaultValue="Your sample add-in loaded succesfully. Go to the HOME tab and click the 'yyyqqq' button to get started."/>
  </bt:LongStrings>
</Resources>

更新信息 #

若将ExtensionPoint替换为以下GetStarted代码，功能可正常运行，但该方式无法通过Microsoft XML验证，不能用于生产环境，怀疑问题出在DesktopFormFactor或ExtensionPoint的配置上：

<GetStarted>
  <Title resid="GetStarted.Title"/>
  <Description resid="GetStarted.Description"/>
  <LearnMoreUrl resid="GetStarted.LearnMoreUrl"/> <!-- TODO: change this to our own -->
</GetStarted>

排查与解决建议 #

• 补全PrimaryCommandSurface的层级结构：当前代码直接在ExtensionPoint下放置Control节点，缺少必要的Group和OfficeTab/CustomTab层级，这会导致按钮的触发逻辑无法正确绑定。正确的结构示例：

<ExtensionPoint xsi:type="PrimaryCommandSurface">
  <OfficeTab id="TabAddIns">
    <Group id="yyyqqq.Group">
      <Label resid="yyyqqq.GroupLabel"/>
      <Icon>
        <bt:Image size="16" resid="Icon.16x16"/>
        <bt:Image size="32" resid="Icon.32x32"/>
        <bt:Image size="80" resid="Icon.80x80"/>
      </Icon>
      <Control xsi:type="Button" id="yyyqqq.Button">
        <Label resid="TaskpaneButton.Title"/>
        <Supertip>
          <Title resid="TaskpaneButton.Title"/>
          <Description resid="TaskpaneButton.Tooltip"/>
        </Supertip>
        <Icon>
          <bt:Image size="16" resid="Icon.16x16"/>
          <bt:Image size="32" resid="Icon.32x32"/>
          <bt:Image size="80" resid="Icon.80x80"/>
        </Icon>
        <Action xsi:type="ShowTaskpane">
          <TaskpaneId>yyyqqq</TaskpaneId>
          <SourceLocation resid="TaskPaneUrl"/>
        </Action>
      </Control>
    </Group>
  </OfficeTab>
</ExtensionPoint>

• 检查任务窗格地址的可用性：确认TaskPaneUrl指向的地址能在Word内置浏览器中正常加载，无证书错误、跨域限制或资源加载失败问题，可直接在浏览器中访问该地址验证。
• 验证manifest语法合规性：使用官方manifest验证工具检查XML结构是否符合Office加载项的规范，排查潜在的语法错误。
• 确认TaskpaneId唯一性：确保yyyqqq这个TaskpaneId在整个manifest中唯一，没有重复定义。
• 检查Office版本兼容性：确认使用的Word版本支持当前manifest中声明的DesktopFormFactor配置，部分旧版本可能对新结构支持不足。

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