如何通过node-gyp暴露静态C库函数？编译无报错但无法导出

你遇到的问题核心有两个：

1. 没有将静态库中的函数绑定到Node.js的导出对象：你的main.cpp仅定义了初始化函数，但没有把abc.a中的任何函数暴露给Node.js环境，所以即使编译成功，最终模块也没有可用的导出内容。
2. 死代码消除（Dead Code Elimination）：因为静态库中的函数没有被你的代码直接引用，编译器会自动剔除这些未使用的代码，导致最终生成的模块文件比静态库小很多。

下面是具体的修复步骤：

1. 在main.cpp中绑定静态库函数到Node.js导出 #

假设你的abc.h中声明了一个函数（比如int calculateSum(int a, int b)），你需要为这个函数编写对应的NAPI包装函数，然后将其添加到exports对象中。修改后的main.cpp如下：

/* main.cpp */
#include <napi.h>
#include "abc.h"

// 包装静态库函数：转换Node.js参数为C++类型，调用静态库函数后返回结果
Napi::Value CalculateSum(const Napi::CallbackInfo& info) {
  Napi::Env env = info.Env();
  
  // 检查参数数量和类型合法性
  if (info.Length() < 2 || !info[0].IsNumber() || !info[1].IsNumber()) {
    Napi::TypeError::New(env, "Expected two numbers as arguments").ThrowAsJavaScriptException();
    return env.Undefined();
  }

  // 转换Node.js参数为C++整数
  int a = info[0].As<Napi::Number>().Int32Value();
  int b = info[1].As<Napi::Number>().Int32Value();

  // 调用静态库中的目标函数
  int result = calculateSum(a, b);

  // 将结果转换为Node.js的Number类型返回
  return Napi::Number::New(env, result);
}

Napi::Object InitAll(Napi::Env env, Napi::Object exports) {
  // 将包装后的函数挂载到exports上，Node.js中可通过testAddon.calculateSum调用
  exports.Set(Napi::String::New(env, "calculateSum"), Napi::Function::New(env, CalculateSum));
  return exports;
}

NODE_API_MODULE(testaddon, InitAll)

2. 防止编译器剔除未直接引用的静态库代码 #

如果你的静态库中有多个函数，其中一些没被main.cpp直接调用但需要暴露给Node.js，编译器可能会把这些未引用的代码剔除。你需要修改binding.gyp的libraries配置，强制链接整个静态库：

{
  "targets": [
    {
      "target_name": "test",
      "cflags!": [ "-fno-exceptions" ],
      "cflags_cc!": [ "-fno-exceptions" ],
      "sources": [ "/data/abc.h", "main.cpp" ],
      "include_dirs": [ "<!@(node -p \"require('node-addon-api').include\")" ],
      // 使用--whole-archive强制链接整个静态库，避免死代码消除
      "libraries": [ "-Wl,--whole-archive", "/data/abc.a", "-Wl,--no-whole-archive" ],
      "dependencies": [ "<!(node -p \"require('node-addon-api').gyp\")" ],
      "defines": [ "NAPI_DISABLE_CPP_EXCEPTIONS" ]
    }
  ]
}

注意：-Wl,--whole-archive和-Wl,--no-whole-archive是GCC链接器的选项，如果你使用MSVC编译器，需要改用/WHOLEARCHIVE:abc.lib和/NOWHOLEARCHIVE。

3. 重新编译并验证 #

执行以下命令重新编译模块：

node-gyp clean && node-gyp configure && node-gyp build

然后运行main.js，你会看到输出包含你暴露的函数：

node main.js
# 输出类似: { calculateSum: [Function] }

为什么生成的模块比静态库小？ #

这是因为默认情况下，链接器会执行死代码消除：它会扫描静态库中所有未被你的代码直接引用的函数/代码段，并将它们从最终的二进制文件中移除，只保留实际用到的部分。当你没有绑定任何静态库函数时，整个静态库的代码都被视为未使用，所以最终的模块只包含Node-API的初始化框架，体积自然远小于静态库。

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