萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Windows 7 下使用 C++ 編寫 Node.js 原生擴充模組完整教學

前置環境

  • Node.js(含 `npm`)
  • Python 2.7(`node-gyp` 依賴)
  • Visual Studio 2013/2015/2017/2019(C++ 編譯工具鏈)
  • Windows 7 SP1+ / Windows 10/11

安裝專案生成工具:

npm install -g node-gyp

專案結構初始化

mkdir node-addon-demo
cd node-addon-demo
mkdir src

binding.gyp(專案配置檔)

{
  "targets": [{
    "target_name": "hello",           // 輸出模組名:hello.node
    "sources": [ "src/hello.cc" ],    // C++ 源檔
    "include_dirs": [ "

src/hello.cc(C++ 實現)

#include 
#include 

using namespace v8;

// 導出函數:Hello
Handle Hello(const Arguments& args) {
    HandleScope scope;
    return scope.Close(String::New("Hello world!"));
}

// 初始化:綁定到 exports
void Init(Handle target) {
    NODE_SET_METHOD(target, "hello", Hello);
}

// 模組入口宏
NODE_MODULE(hello, Init)

編譯流程

# 1. 生成 VS 專案檔
node-gyp configure
# 輸出:build/hello.vcxproj 等

# 2. 編譯(Release 模式)
node-gyp build --configuration=Release
# 輸出:build/Release/hello.node

或直接在 Visual Studio 開啟 `.sln` 進行編輯/除錯。

測試載入

// test.js
var hello = require('./build/Release/hello');
console.log(hello.hello()); // 輸出: Hello world!
$ node test.js
Hello world!

常見坑點與解決

問題原因解決
LNK1104: cannot open 'node.lib'VS 專案預期 Debug 目錄下有 node.lib在 `/.node-gyp//` 建立 `Debug` 資料夾,複製 `Release/node.lib` 過去
模組名不匹配`NODE_MODULE(hello, Init)` 需與 `target_name`、檔名 `hello.node` 一致三者保持一致:`target_name: "hello"`、`NODE_MODULE(hello, ...)`、`require('./hello')`
`conditions` 中 `-lnode.lib` 報錯舊教材遺留配置,新版 `node-gyp` 自動鏈結移除 `binding.gyp` 中 `libraries: ['-lnode.lib']`
Node 版本升級後模組失效ABI 變更,原生模組需重新編譯使用 NAN (Native Abstractions for Node.js) 或 **Node-API (N-API)** 實現跨版本穩定 ABI

現代化建議:改用 N-API / node-addon-api

N-API(Node 8+ 穩定)提供跨版本穩定 ABI,避免每次 Node 升級重編。配合 `node-addon-api` (C++ 包裝器) 體驗更佳:

// binding.gyp 追加
"dependencies": ["
// src/hello.cpp (node-addon-api 風格)
#include 

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

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

NODE_API_MODULE(hello, Init)

編譯後 `.node` 檔可在 Node 8~最新版直接載入,無需重編。

copyright © 萬盛學電腦網 all rights reserved