Node-API（N-API）

定义

Node-API(曾称 N-API)是 Node.js 为原生扩展(native addon)提供的官方 C 接口层。它把插件开发从直接调用 V8 API 中解耦出来,提供一套 ABI 稳定的抽象接口。

背景

早期原生模块直接依赖 V8 头文件,V8 升级经常破坏二进制兼容,导致每次 Node 大版本更新后所有原生模块都要重新编译,社区曾靠 NAN 宏库缓解。Node-API 从 Node.js 8 引入、10 起稳定,承诺同一 Node-API 版本编译出的二进制在后续 Node 版本上无需重编译即可运行。

应用

数据库驱动、图像处理、加密、机器学习绑定等性能敏感模块广泛使用 Node-API,配合 node-addon-api(C++ 封装)或 napi-rs(Rust 封装)开发。better-sqlite3、sharp 等知名库均为原生扩展。

意义

Node-API 让 Node 生态的原生模块进入"一次编译、多版本运行"时代,也为 Rust 等语言进入 Node 生态铺平了道路。