Excel JS自定义函数插件#NAME错误：公式前缀异常问题咨询

错误原因 #

• FUNCRES.XLAM兼容层误映射：FUNCRES.XLAM是Excel分析工具库的组件，用于兼容旧版VBA自定义函数。当Excel无法正确识别你的JS自定义函数归属时，会错误地将其归类到这个兼容层，导致公式被加上前缀。
• 自定义函数注册缓存损坏：Excel会缓存已注册的自定义函数信息，一旦缓存文件损坏或加载项启动时未更新缓存，保存文件时Excel无法关联函数到你的加载项，就会用FUNCRES前缀标记未识别的函数。
• 加载项启动时序滞后：如果你的加载项在Excel完成文件公式解析后才完成自定义函数注册，打开文件时Excel找不到函数定义，就会 fallback 到FUNCRES的兼容格式。

规避方法 #

• 规范自定义函数注册与调用：
  检查加载项的XML清单文件，确保<Function>节点的Name和Namespace属性准确且唯一，避免与系统内置或其他加载项冲突。调用函数时必须带上命名空间，比如你的函数名为Test，命名空间为Contoso，则使用=Contoso.Test()，让Excel明确识别函数归属。
• 重置Excel自定义函数缓存：
  1. 关闭所有Excel进程
  2. 删除以下路径的缓存文件：
     • %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\ 下的所有文件
     • %APPDATA%\Microsoft\Excel\XLSTART\ 中无关的加载项文件
  3. 重启Excel并重新加载你的加载项
• 优化加载项启动逻辑：
  在Office.initialize事件中优先执行自定义函数的注册代码，确保Excel解析公式前完成函数注册。如果有异步初始化操作，使用await保证注册逻辑优先完成。
• 禁用不必要的分析工具库：
  打开Excel「文件」→「选项」→「加载项」，在「管理」下拉选择「Excel加载项」，点击「转到」，取消勾选「分析工具库」，减少FUNCRES.XLAM的干扰。
• 使用正确的文件保存格式：
  确保工作表保存为.xlsx或.xlsm格式，避免使用旧版.xls格式——旧格式对JS自定义函数的支持有限，更容易出现归属识别错误。

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