Windows下构建Node.js N-API插件报错：找不到napi.h文件

错误核心原因 #

编译时提示Cannot open include file: 'napi.h'，本质是node-addon-api依赖未正确安装，或代码/配置存在冗余导致头文件路径解析失败。

具体解决步骤 #

1. 安装node-addon-api依赖 #

在项目根目录执行命令，安装插件必需的封装库：

npm install node-addon-api --save

若全局node-gyp存在版本问题，可重新安装：

npm install -g node-gyp

2. 修正addon.cpp的头文件引用 #

你的代码同时引入了<node_api.h>和<napi.h>，但使用node-addon-api仅需保留后者（node-addon-api已封装原生node_api.h的功能），删除冗余引用：

#include <napi.h>

Napi::String HelloWorld(const Napi::CallbackInfo& info) {
    Napi::Env env = info.Env();
    return Napi::String::New(env, "Hello, world!");
}

Napi::Object Init(Napi::Env env, Napi::Object exports) {
    exports.Set(Napi::String::New(env, "hello"), Napi::Function::New(env, HelloWorld));
    return exports;
}

NODE_API_MODULE(addon, Init)

3. 验证binding.gyp配置有效性 #

你的binding.gyp配置本身合规，可手动验证路径解析是否正常：
在项目根目录执行：

node -p "require('node-addon-api').include"

若输出为有效本地路径（如C:\Users\79832\my-addon\node_modules\node-addon-api），说明配置没问题；若输出为空或报错，需重新执行步骤1安装依赖。

4. 重新执行构建 #

先清理旧构建缓存，再重新配置编译：

node-gyp clean
node-gyp configure build

额外排查点 #

• 若仍报错，尝试以管理员权限打开命令提示符执行构建命令
• 确保VS2022构建工具配置正确，可手动指定VS版本：

npm config set msvs_version 2022

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