如何在node-gyp中引入Boost与Quantlib两个C++库

1. 先确认QuantLib库类型匹配需求 #

• 你当前用到的QuantLib-mt.lib如果是静态编译生成的静态库，不需要配套.dll文件，代码会直接打包进最终生成的.node扩展中；如果是动态编译生成的导入库，才需要对应.dll文件随.node文件一起发布，运行时放在同目录或系统PATH路径下即可。
• 区分方式：查看编译QuantLib时的Visual Studio项目配置，「配置属性-常规-配置类型」选「静态库(.lib)」生成的就是无依赖的静态库，选「动态库(.dll)」生成的就是需要配套.dll的导入库。

2. 修正binding.gyp配置 #

你的配置缺少两个关键项：静态链接QuantLib必需的宏定义、和QuantLib编译参数对齐的运行时配置，修正后的参考配置如下：

{
  "targets": [
    {
      "target_name": "hello",
      "sources": [ "src/hello.cc", "src/test.cpp", "src/test.h"],
      "include_dirs": ["<!(node -e \"require('nan')\")", "eigen-3.3.7/eigen-3.3.7", "."],
      "libraries": ["<(module_root_dir)/Quantlib/QuantLib-mt.lib"],
      "defines": ["QL_STATIC_LIB"],
      "msvs_settings": {
        "VCCLCompilerTool": {
          "RuntimeLibrary": 0
        }
      }
    }
  ]
}

配置说明： #

• QL_STATIC_LIB宏是静态链接QuantLib的必填项，不添加的话头文件会默认将函数标记为dll导入，导致链接时找不到符号。
• RuntimeLibrary的值要和你编译QuantLib时的运行时参数对齐：0对应/MT（多线程静态 Release版），1对应/MTd（多线程静态 Debug版），2对应/MD（多线程动态 Release版），3对应/MDd（多线程动态 Debug版），参数不匹配会出现大量链接冲突。

3. 环境对齐校验 #

• 确认QuantLib编译的架构（x86/x64）和你安装的Node.js架构完全一致，比如Node是x64版本就必须用x64编译的QuantLib库。
• 确认编译QuantLib使用的MSVC工具集版本和node-gyp调用的工具集版本一致，避免跨版本编译的兼容问题。

4. 报错排查方向 #

• 编译提示找不到ql开头的头文件：检查include_dirs配置，要包含ql头文件所在的上级目录。
• 链接提示QuantLib相关符号未定义：优先检查是否添加QL_STATIC_LIB宏、运行时参数是否匹配、库架构是否对应。
• 运行时提示找不到QuantLib.dll：说明你用的是动态库的导入库，把对应.dll文件放到生成的.node文件同目录即可。

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