NodeJS 中使用native module - 不同方式介绍

最新推荐文章于 2024-06-06 20:53:00 发布

原创

最新推荐文章于 2024-06-06 20:53:00 发布 · 2.3k 阅读

2 ·

CC 4.0 BY-SA版权

本文介绍了在NodeJS中如何使用Native Module，包括C++ AddOn、NAN（NAPI）和N-API三种方式。C++ AddOn存在版本兼容问题，NAN能自动适配不同Node版本，而N-API则是稳定的ABI接口，确保跨版本兼容。在实际使用中，作者发现版本不匹配会导致运行错误，推荐使用N-API以解决这个问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

写NodeJS 程序的时候，往往不会全是JS的，不管是什么原因需要利用原来的DLL去实现一些特定的业务，那么NodeJS怎么去实现对DLL的调用呢？

NodeJS对模块的调用都是通过require("module")来实现的，那么我们就需要编写一个binary可以通过require("")加载的。要想编译成.node文件，那就必须说node-gyp tool了。

node-gyp 是基于 GYP[^4] 的。它会识别包或者项目中的 binding.gyp[^5] 文件，然后根据该配置文件生成各系统下能进行编译的项目，如 Windows 下生成 Visual Studio 项目文件（*.sln 等），Unix 下生成 Makefile。在生成这些项目文件之后，node-gyp 还能调用各系统的编译工具（如 GCC）来将项目进行编译，得到最后的动态链接库 *.node 文件。具体使用可以参考官网以及Git

方法一：C++ AddOn

你可以参考NodeJS的官方说明，按照说明，如果按照这种方法开发出的AddOn只能支持特定版本，主要是由于V8引擎的各个版本的接口是变化的，甚至有的时候函数参数类型都会在个版本之间不同，所以该方法不建议使用。

方法二: NAN方式，也称为NAPI

在NodeJS的官方网站上没有该方面的说明，但是可以从Git上查看使用原理，NAN 是 Node.js 原生模块抽象接口可能还是有点抽象，那么讲明白点，