Node.js中创建窗口并监听Windows原生消息的解决方案求助

嘿，我完全懂你的痛点——为了个hwnd和消息监听就拉个Electron浏览器确实大材小用，而且原生插件那堆兼容性问题真的头大。既然你没C++经验，咱们就用纯Node.js生态里的工具搞定，不用碰一行原生代码：

核心思路：直接调用Windows系统API（无需自己写原生插件） #

我们可以用ffi-napi这个Node.js模块直接调用Win32 API，它能帮我们在JS里声明并调用系统函数，完全绕开手动编写C++原生插件的流程。搭配ref-napi和ref-struct-napi来处理C语言的结构体和指针类型。

步骤1：安装依赖 #

打开终端，在你的Node.js项目里安装所需模块：

npm install ffi-napi ref-napi ref-struct-napi

步骤2：编写代码创建隐藏窗口、获取hwnd并监听消息 #

下面是完整的可运行代码，它会创建一个完全隐藏的Win32窗口（你不需要显示它，只是要它的hwnd），然后启动消息循环监听第三方程序发来的原生消息：

const ffi = require('ffi-napi');
const ref = require('ref-napi');
const StructType = require('ref-struct-napi');

// 定义Win32 API需要的结构体
const WNDCLASSEX = StructType({
  cbSize: ref.types.uint32,
  style: ref.types.uint32,
  lpfnWndProc: ref.types.pointer,
  cbClsExtra: ref.types.int32,
  cbWndExtra: ref.types.int32,
  hInstance: ref.types.pointer,
  hIcon: ref.types.pointer,
  hCursor: ref.types.pointer,
  hbrBackground: ref.types.pointer,
  lpszMenuName: ref.types.CString,
  lpszClassName: ref.types.CString,
  hIconSm: ref.types.pointer
});

const MSG = StructType({
  hwnd: ref.types.pointer,
  message: ref.types.uint32,
  wParam: ref.types.uint32,
  lParam: ref.types.int64,
  time: ref.types.uint32,
  pt: ref.types.pointer
});

// 加载系统dll
const user32 = ffi.Library('user32', {
  'RegisterClassExW': ['uint16', [WNDCLASSEX]],
  'CreateWindowExW': ['pointer', ['uint32', 'string', 'string', 'uint32', 'int32', 'int32', 'int32', 'int32', 'pointer', 'pointer', 'pointer', 'pointer']],
  'GetMessageW': ['int32', [MSG, 'pointer', 'uint32', 'uint32']],
  'TranslateMessage': ['int32', [MSG]],
  'DispatchMessageW': ['uint32', [MSG]],
  'DefWindowProcW': ['uint32', ['pointer', 'uint32', 'uint32', 'int64']]
});

const kernel32 = ffi.Library('kernel32', {
  'GetModuleHandleW': ['pointer', ['string']]
});

// 获取当前进程的模块句柄
const hInstance = kernel32.GetModuleHandleW(null);

// 定义窗口消息处理函数
const wndProc = ffi.Callback('uint32', ['pointer', 'uint32', 'uint32', 'int64'], (hwnd, msg, wParam, lParam) => {
  // 替换为第三方实际发送的消息ID，比如WM_USER+自定义编号（WM_USER是0x0400）
  if (msg === 0x0400 + 100) { 
    console.log(`收到原生消息：msg=${msg}, wParam=${wParam}, lParam=${lParam}`);
    // 在这里编写你的消息处理逻辑
    return 0;
  }

  // 其他消息交给系统默认处理
  return user32.DefWindowProcW(hwnd, msg, wParam, lParam);
});

// 注册窗口类
const wc = new WNDCLASSEX();
wc.cbSize = WNDCLASSEX.size;
wc.lpfnWndProc = wndProc;
wc.lpszClassName = 'NodeJS_Hidden_Window_Class';
wc.hInstance = hInstance;
user32.RegisterClassExW(wc);

// 创建隐藏窗口
const hwnd = user32.CreateWindowExW(
  0, // 扩展样式
  'NodeJS_Hidden_Window_Class', // 窗口类名
  'NodeJS Hidden Window', // 窗口标题（隐藏状态下无意义）
  0, // 窗口样式（设为0确保隐藏）
  0, 0, 0, 0, // 位置和大小都设为0
  null, null, hInstance, null
);

console.log(`成功创建窗口，hwnd: ${hwnd.address().toString(16)}`); // 输出hwnd的十六进制值，可直接传给第三方程序

// 启动消息循环（用setImmediate避免阻塞Node.js事件循环）
function runMessageLoop() {
  const msg = new MSG();
  if (user32.GetMessageW(msg, null, 0, 0) > 0) {
    user32.TranslateMessage(msg);
    user32.DispatchMessageW(msg);
    setImmediate(runMessageLoop);
  }
}

runMessageLoop();

关键说明： #

• 这个窗口是完全隐藏的，不会在任务栏或桌面上显示，仅作为接收消息的载体
• 你可以把hwnd.address().toString(16)输出的句柄值直接传给第三方程序
• 在wndProc函数里，替换msg === 0x0400 + 100为第三方实际发送的消息ID，就能捕获并处理目标消息
• 消息循环用setImmediate异步执行，不会阻塞Node.js的其他异步任务

备选方案：用现成的封装模块 #

如果你觉得直接调用API太繁琐，可以试试win32-window这个npm模块，它已经封装了创建窗口、获取hwnd和监听消息的功能，代码更简洁：

npm install win32-window

示例代码（简化版）：

const { Window } = require('win32-window');

const win = new Window({
  title: 'Hidden Node Window',
  visible: false, // 隐藏窗口
  width: 0,
  height: 0
});

console.log(`hwnd: ${win.hwnd}`);

// 监听原生消息
win.on('message', (msg) => {
  if (msg.message === 0x0400 + 100) {
    console.log('收到第三方消息:', msg);
  }
});

这个模块底层也是用ffi-napi实现的，只是做了更友好的封装，适合不想写太多底层代码的场景。

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