【Electron教程】第17节与原生模块交互（Node.js C++ Addons）

原创于 2025-11-26 06:00:00 发布 · 643 阅读

21 ·

CC 4.0 BY-SA版权

文章标签：

#electron #交互 #node.js #javascript #前端 #c++ #node-gyp

Electron技术栈专栏收录该内容

21 篇文章

订阅专栏

🐋 第17节与原生模块交互（Node.js C++ Addons）：Electron开发进阶教程

⌚老曹带你深入 Electron 的原生模块交互技术！本章节将全面解析如何调用原生模块以及使用 node-gyp编译模块。通过学习，你将掌握从基础到高级的知识点，并能设计出高效、可靠的原生模块集成方案。

📖 引言

在桌面应用开发中，有时需要调用底层系统功能或优化性能，这就需要用到 Node.js 的原生模块（C++ Addons）。Electron 支持通过 node-gyp 编译和加载这些模块，从而实现与底层系统的无缝交互。本章节将为你揭示如何优雅地集成原生模块，并确保其稳定性和性能。

🔑 本章内容概览

🎯 调用原生模块
🛠️ 使用 node-gyp 编译模块
💡 最佳实践：如何优化原生模块的使用
⚡ 重难点分析
🏆 十大高频面试题及答案

1️⃣ 🎯 调用原生模块

📌 1.1 什么是原生模块？

原生模块是用 C++ 编写的扩展模块，能够直接访问底层系统资源，提供更高的性能和灵活性。

📌 1.2 如何加载原生模块？

以下是一个简单的示例：

const addon = require('./build/Release/addon.node');

console.log(addon.hello()); // 输出: 'Hello from C++'

📌 1.3 注意事项

确保模块已正确编译并生成 .node 文件。
模块路径需为绝对路径或打包后的相对路径。

2️⃣ 🛠️ 使用 `node-gyp` 编译模块

📌 2.1 什么是 `node-gyp`？

node-gyp 是一个跨平台工具，用于编译 Node.js 原生模块。它基于 gyp 工具链，支持多种平台和架构。

📌 2.2 如何配置 `node-gyp`？

创建 binding.gyp 文件，定义模块的编译规则：

{
  "targets": [
    {
      "target_name": "addon",
      "sources": [ "src/addon.cc" ]
    }
  ]
}

初始化 node-gyp 配置：

npm install -g node-gyp
node-gyp configure

编译模块：

node-gyp build

📌 2.3 示例：编写一个简单的 C++ 模块

以下是一个简单的 C++ 模块示例：

#include <node.h>

namespace demo {

using v8::FunctionCallbackInfo;
using v8::Isolate;
using v8::Local;
using v8::Object;
using v8::String;
using v8::Value;

void Hello(const FunctionCallbackInfo<Value>& args) {
  Isolate* isolate = args.GetIsolate();
  args.GetReturnValue().Set(String::NewFromUtf8(isolate, "Hello from C++").ToLocalChecked());
}

void Initialize(Local<Object> exports) {
  NODE_SET_METHOD(exports, "hello", Hello);
}

NODE_MODULE(NODE_GYP_MODULE_NAME, Initialize)

}  // namespace demo