调用外部DLL的C++ XLL无法在Excel中打开的原因排查

以下是可能导致该错误的几个常见原因及对应的排查/解决方法：

• 架构不匹配（32位/64位冲突）
  Excel对XLL的位数要求严格：32位Excel只能加载32位XLL及依赖DLL，64位同理。如果你的main DLL和XLL项目的目标平台（x86/x64）不一致，即使编译链接通过，Excel加载时会因依赖库位数不兼容，抛出格式不匹配的错误。
  解决：检查两个项目的项目属性 -> 配置属性 -> 平台，确保都设置为与Excel相同的位数；同时确认平台工具集版本一致。

• XLL关键导出函数缺失
  XLL必须导出特定的入口函数（如xlAutoOpen、xlAutoClose、xlAddInManagerInfo等）才能被Excel识别。如果链接main DLL时，意外覆盖或破坏了XLL的导出表，会导致Excel无法识别XLL格式。
  排查：用VS自带的dumpbin工具查看XLL的导出表：

  dumpbin /exports your_xll_file.xll
  

  确认必要的XLL入口函数都在导出列表中。如果缺失，检查XLL项目的链接选项，确保手动添加了这些函数的导出（如在链接器->输入->模块定义文件中指定.def，或用__declspec(dllexport)标记入口函数）。

• 依赖DLL缺失或加载失败
  当XLL依赖的main DLL无法被找到时，Excel加载XLL会失败，并可能给出“格式不匹配”的模糊错误提示（而非明确的DLL缺失错误）。
  解决：将main DLL复制到XLL所在目录，或添加其路径到系统环境变量PATH；也可以在XLL项目中设置延迟加载（链接器->输入->延迟加载的DLL，添加main.dll），并在代码中处理DLL加载失败的情况。

• 运行时库配置不一致
  如果main DLL和XLL项目的运行时库设置不同（比如一个用MD（多线程DLL），另一个用MT（多线程静态库）），会导致生成的XLL存在运行时冲突，加载时被Excel判定为格式异常。
  解决：检查两个项目的项目属性 -> C/C++ -> 代码生成 -> 运行时库，确保设置完全一致（如都用MD或MDd，不要混合）。

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