Excel 2016 for Mac插件ShowTaskpane与TaskpaneId兼容异常

我之前在维护Excel Mac插件时也碰到过一模一样的问题！从v15.40升级到v16.9后，原本靠TaskpaneId实现的任务窗格共享突然失效，折腾了好一阵才搞清楚是版本迭代带来的配置和逻辑变化，不是你的代码写错了。下面是几个关键的排查和解决方向：

1. 清单文件Schema版本不兼容 #

Excel 2016 for Mac v16.x开始对插件清单的Schema版本有了更高要求，旧版本的Schema（比如Office 1.0）不再支持TaskpaneId的共享逻辑。你需要检查清单里的<VersionOverrides>节点，确保它指向正确的高版本Schema，比如：

<VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    <!-- 你的插件配置内容 -->
  </VersionOverrides>
</VersionOverrides>

至少要用到VersionOverridesV1_1及以上的版本，才能让TaskpaneId的共享逻辑正常工作。

2. TaskpaneId大小写敏感性变更 #

v15.40版本的Mac Excel对TaskpaneId的大小写不做区分，但v16.9之后开始严格校验大小写匹配。你要仔细检查所有用到这个ID的地方：

• ShowTaskpane动作里的<TaskpaneId>
• 清单<ExtensionPoints>中<CustomTaskPane>的<CustomTaskPaneId>
• 如果代码里有手动调用任务窗格的逻辑，也要确保ID大小写完全一致

比如你用的是MyPane，就不能在其他地方写成mypane或Mypane，必须完全匹配。

3. 缺少任务窗格的显式定义 #

旧版本中，可能只通过ShowTaskpane动作就能自动创建共享任务窗格，但v16.x要求你必须在清单里显式定义对应的自定义任务窗格。你需要在<ExtensionPoints>节点下添加如下配置：

<ExtensionPoint xsi:type="CustomTaskPane">
  <CustomTaskPaneId>MyPane</CustomTaskPaneId>
  <SourceLocation resid="myproject.url.base.in"/>
  <Title resid="myPaneTitle"/> <!-- 这个resid要对应你清单里的字符串资源 -->
  <Hosts>
    <Host Name="Workbook"/>
  </Hosts>
</ExtensionPoint>

确保这里的CustomTaskPaneId和ShowTaskpane动作里的TaskpaneId完全一致，SourceLocation也要和动作里的保持相同。

4. 清除插件缓存 #

Mac Excel v16.x有时候会缓存旧的插件配置，导致新的设置不生效。你可以手动清除缓存：

• 关闭Excel
• 打开访达，按Cmd+Shift+G，输入~/Library/Containers/com.microsoft.Excel/Data/Library/Application Support/com.microsoft.Excel/Office/AddIns
• 删除对应插件的缓存文件
• 重新打开Excel并加载插件

如果以上步骤都试过还是不行，建议你创建一个极简的测试插件，只保留必要的ShowTaskpane动作和自定义任务窗格定义，验证是否能正常共享，排除其他复杂配置的干扰。

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