在NW.js应用中使用node-pty时遭遇DLL初始化失败错误

在Windows 10系统的NW.js应用中，使用xterm.js和node-pty实现终端模拟器时，出现DLL初始化失败错误，报错日志如下：

Uncaught Error: Eine DLL-Initialisierungsroutine ist fehlgeschlagen. 

\\?\C:\Users\volke.a\Z_local\nwjstart\node_modules\node-pty\build\Release\conpty.node     at Module._extensions..node (node:internal/modules/cjs/loader:1365:18)     at Module.load (node:internal/modules/cjs/loader:1116:32)     at Module._load (node:internal/modules/cjs/loader:963:12)     at Module.require (node:internal/modules/cjs/loader:1140:19)     at require (node:internal/modules/helpers:117:18)     at new WindowsPtyAgent (C:\Users\volke.a\Z_local\nwjstart\node_modules\node-pty\lib\windowsPtyAgent.js:41:36)     at new WindowsTerminal (C:\Users\volke.a\Z_local\nwjstart\node_modules\node-pty\lib\windowsTerminal.js:51:24)     at Object.spawn (C:\Users\volke.a\Z_local\nwjstart\node_modules\node-pty\lib\index.js:29:12)     at chrome-extension://fnhkclelbagcndnlaobahcdeinlcloek/terminal.js:15:24

注：Eine DLL-Initialisierungsroutine ist fehlgeschlagen 意为“DLL初始化例程失败”。

使用的核心代码如下：

const os = require('os');
const pty = require('node-pty');
const { Terminal } = require('xterm');

win = nw.Window.get()
win.x = 100
win.y = 100

// Create a new terminal instance
const terminalContainer = document.getElementById('terminal');
const term = new Terminal();
term.open(terminalContainer);
// Start a PowerShell terminal session using node-pty
const shell = os.platform() === 'win32' ? 'powershell.exe' : 'bash';
const ptyProcess = pty.spawn(shell, [], {
  name: 'xterm-color',
  cols: 80,
  rows: 30,
  cwd: process.cwd(),
  env: process.env
});

// Pipe terminal output to xterm.js
ptyProcess.onData(data => term.write(data));
term.onData(data => ptyProcess.write(data));

// Handle command line input
term.onKey(e => {
  const printable = !e.domEvent.altKey && !e.domEvent.ctrlKey && !e.domEvent.metaKey;

  if (e.domEvent.keyCode === 13) {
    ptyProcess.write('\r\n');
  } else if (printable) {
    ptyProcess.write(e.key);
  }
});

已尝试更新npm、Node.js、node-pty、xterm及NW.js，但问题仍未解决。

1. 针对NW.js的Node版本重新编译node-pty #

node-pty是原生Node模块，必须与NW.js内置的Node版本完全匹配才能正常加载：

• 在NW.js应用的开发者控制台中运行process.versions.node，确认内置Node版本
• 安装nw-gyp工具：npm install -g nw-gyp
• 进入node-pty目录执行重新编译：

  cd node_modules/node-pty
  nw-gyp rebuild --target=<你的NW.js版本号> --arch=x64
  

  例：NW.js版本为0.79.0时，命令为nw-gyp rebuild --target=0.79.0 --arch=x64

2. 强制禁用ConPTY，使用WinPTY替代 #

ConPTY在部分Windows环境下存在兼容性问题，可通过配置回退到传统WinPTY：
修改pty.spawn的配置项，添加useConpty: false：

const ptyProcess = pty.spawn(shell, [], {
  name: 'xterm-color',
  cols: 80,
  rows: 30,
  cwd: process.cwd(),
  env: process.env,
  useConpty: false
});

3. 检查系统版本与运行权限 #

• 确认Windows 10版本为1809（Build 17763）及以上，ConPTY仅支持该版本及更高系统
• 右键NW.js应用，选择“以管理员身份运行”，权限不足可能导致DLL加载失败

4. 清理依赖缓存后重新安装 #

删除现有依赖文件，重新适配NW.js版本安装：

rm -rf node_modules package-lock.json
npm install --nwjs_build_type=sdk --target=<你的NW.js版本号>

也可在package.json中添加NW.js配置，后续安装自动适配：

{
  "nw": {
    "targets": ["win64"],
    "version": "0.79.0"
  }
}

添加后执行npm install即可。

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