Excel自定义函数Add-in导入模块后被禁用，为何禁用后可正常运行？

可能原因 #

• Office客户端模块检测延迟：Excel自定义函数的运行环境对ES模块的兼容性检测存在滞后。当你在function.js中使用import导入模块时，加载项初始化阶段的检测逻辑会误判代码存在加载异常，将函数标记为禁用，但后续模块加载完成后，函数就能正常执行。
• 加载项清单配置不全：如果manifest.xml里没有正确声明模块加载支持，比如<Runtime>节点未设置JavaScriptRuntimeVersion为1.8及以上版本，Office客户端会以旧模式加载代码，导致初始状态误判。
• 调试缓存冲突：开发调试时，Office客户端或浏览器的缓存留存了旧版无模块的代码，新导入模块后的代码加载时，缓存与新代码产生冲突，引发初始禁用标记，但实际执行时调用的是新代码。
• 函数注册时机滞后：导入模块会推迟函数注册代码的执行时间，Office客户端初始化时没检测到已注册的函数，因此标记为禁用，后续注册完成后函数即可正常工作。

解决建议 #

• 检查并更新加载项清单的<Runtime>配置：

  <Runtime>
    <Override type="javascript" runtimeVersion="1.8" resid="Functions.Script.Url"/>
  </Runtime>
  

• 清理Office客户端和浏览器的缓存，重启Excel后重新加载加载项。
• 调整函数注册时机，等所有模块加载完成后再执行注册逻辑，比如用Promise.all处理模块导入后调用CustomFunctions.associate。
• 使用Webpack等打包工具将所有模块打包为单文件，避免运行时模块加载延迟。

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