Office加载项开发：多宿主加载项能否添加自定义Excel函数？

可以构建同时支持Word/Excel通用功能和Excel自定义函数的单Office加载项，你之前修改未生效大概率是manifest配置或项目结构的细节没处理到位，以下是关键配置步骤和注意事项：

1. Manifest文件核心配置 #

需要在原有双宿主配置基础上，添加Excel自定义函数专属的ExtensionPoint节点，且该节点必须嵌套在<Host xsi:type="Workbook">下，不能放在通用Hosts区域。

示例关键片段：

<!-- 原有双宿主Hosts配置 -->
<Hosts>
  <Host Name="Document"/> <!-- Word宿主 -->
  <Host Name="Workbook"/> <!-- Excel宿主 -->
</Hosts>

<!-- VersionOverrides区域添加自定义函数配置 -->
<VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
  <Hosts>
    <!-- Excel专属配置：包含自定义函数 -->
    <Host xsi:type="Workbook">
      <AllFormFactors>
        <ExtensionPoint xsi:type="CustomFunctions">
          <Script>
            <SourceLocation resid="CustomFunctions.Script.Url"/>
          </Script>
          <Metadata>
            <SourceLocation resid="CustomFunctions.Metadata.Url"/>
          </Metadata>
        </ExtensionPoint>
        <!-- 保留Excel的任务窗格ExtensionPoint配置 -->
      </AllFormFactors>
    </Host>
    <!-- Word专属配置：保留原有任务窗格/命令栏配置 -->
    <Host xsi:type="Document">
      <AllFormFactors>
        <ExtensionPoint xsi:type="PrimaryCommandSurface">
          <!-- 你的Word命令栏/任务窗格配置 -->
        </ExtensionPoint>
      </AllFormFactors>
    </Host>
  </Hosts>

  <Resources>
    <bt:Urls>
      <!-- 新增自定义函数相关路径 -->
      <bt:Url id="CustomFunctions.Script.Url" DefaultValue="https://localhost:3000/dist/custom-functions.js"/>
      <bt:Url id="CustomFunctions.Metadata.Url" DefaultValue="https://localhost:3000/dist/custom-functions.json"/>
      <!-- 保留原有任务窗格等路径配置 -->
    </bt:Urls>
  </Resources>
</VersionOverrides>

2. Webpack配置调整 #

自定义函数需要单独打包为独立脚本，不能和任务窗格代码混同，否则Office无法识别。

示例webpack入口配置：

module.exports = {
  entry: {
    taskpane: './src/taskpane/taskpane.ts', // 原双宿主通用代码入口
    'custom-functions': './src/custom-functions/custom-functions.ts' // 自定义函数独立入口
  },
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: '[name].js'
  },
  // 确保安装并配置custom-functions-metadata-plugin，自动生成元数据json文件
  plugins: [
    new CustomFunctionsMetadataPlugin({
      output: 'dist/custom-functions.json'
    })
  ]
};

3. 代码结构与规范 #

• 通用功能代码（同时支持Word/Excel）放在共享目录（如src/shared/），通过Office.context.host判断当前宿主，避免跨宿主执行无效逻辑。
• 自定义函数代码单独放在src/custom-functions/，必须用/** @customfunction */注释标记函数，且导出为顶层函数：

  /**
   * 自定义加法函数
   * @customfunction
   * @param a 第一个数字
   * @param b 第二个数字
   * @returns 两数之和
   */
  export function add(a: number, b: number): number {
    return a + b;
  }
  

4. 常见踩坑点 #

• 自定义函数脚本必须独立，不能和任务窗格脚本合并打包；
• Manifest中CustomFunctions节点必须严格嵌套在Workbook类型的Host下；
• 本地调试时确保HTTPS证书有效，且自定义函数脚本的端口与任务窗格一致；
• 元数据json文件需正确生成，依赖custom-functions-metadata-plugin插件自动处理。

只要按上述配置调整，即可实现单加载项同时支持双宿主通用功能和Excel自定义函数。

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