开发人员可以借助自定义函数向 Excel 添加新函数，方法是在 JavaScript 中将这些函数定义为加载项的一部分。 Excel 中的用户可以访问自定义函数，就像他们访问 Excel 中的任何本机函数一样，比如 SUM()。

注意

自定义函数 是一个通用术语，可与 用户定义的函数互换。 这两个术语都适用于 VBA、COM 和 Office.js 加载项。Office 加载项文档在引用使用 Office JavaScript API 的自定义 函数时使用 术语自定义函数。

重要

请注意，以下平台上可以使用 Excel 自定义函数。

以下各项当前不支持 Excel 自定义函数：

以下动态图像显示调用你使用 JavaScript 或 TypeScript 创建的函数的工作簿。 在此示例中，自定义函数 =MYFUNCTION.SPHEREVOLUME 计算球的体积。

以下代码定义 =MYFUNCTION.SPHEREVOLUME 自定义函数。

如果使用 适用于 Office 加载项的 Yeoman 生成器 创建 Excel 自定义函数加载项项目，则它可创建控制函数和任务窗格的文件。 我们将专注于对自定义函数至关重要的文件。

提示

Office 加载项的 Yeoman 生成器提供了多个 Excel 自定义函数 项目。 建议 使用共享运行时选择项目类型“Excel 自定义函数 ”和脚本类型 “JavaScript”。

脚本文件 (./src/functions/functions.js or ./src/functions/functions.ts) 包含定义自定义函数的代码以及定义函数的注释。

以下代码定义 add 自定义函数。 代码注释用于生成描述 Excel 自定义函数的 JSON 元数据。 首先声明所需的 @customfunction 注释，指示这是一个自定义函数。 接下来，声明两个参数 first 和 second，然后是它们的 description 属性。 最后提供了 returns 描述。 要详细了解自定义函数需要哪些注释，请参阅为自定义函数创建 JSON 元数据。

用于定义自定义函数的加载项的 XML 清单文件（适用于 Office 的 Yeoman 生成器 创建的项目中的 ./manifest.xml）会执行以下操作。