Node.js child_process执行node -v报错，command not found/ENOENT求助

我尝试用两种方式通过child_process获取当前Node.js版本，均出现错误，代码及错误信息如下：

测试1（exec方式） #

import { exec as cExec } from "child_process";
import { promisify } from "util";
const exec = promisify(cExec);

const cmd = `node -v`;

const { stdout, stderr } = await exec(cmd);
if (stderr) throw new Error(stderr);
console.log(stdout);

错误1： #

Error: Command failed: node -v
/bin/sh: node: command not found

/bin/sh: node: command not found
ChildProcess.exithandler:node:child_process:419:12
ChildProcess.emit:node:events:513:28

测试2（spawn方式） #

const { spawn } = require('node:child_process');

const ls = spawn('node', ['-v']);

ls.stdout.on('data', (data) => {
  console.log(`stdout: ${data}`);
});

ls.stderr.on('data', (data) => {
  console.error(`stderr: ${data}`);
});

ls.on('close', (code) => {
  console.log(`child process exited with code ${code}`);
});

错误2： #

Error: spawn node ENOENT

ChildProcess._handle.onexit:child_process:283:19
onErrorNT:child_process:476:16

问题原因 #

这两个错误本质都是子进程无法找到node可执行文件的路径，常见原因包括：

• 子进程的PATH环境变量与主Node进程不一致，导致找不到node的安装目录
• 部分系统（如Debian/Ubuntu）中，Node.js的可执行文件名为nodejs而非node
• 直接使用node命令时，系统无法在PATH中定位到对应的可执行文件

解决方案 #

方案1：使用当前Node进程的绝对路径（最可靠）

直接用process.execPath获取当前运行的Node可执行文件的绝对路径，代替node命令，从根源避免路径问题：

修改后的测试1代码：

import { exec as cExec } from "child_process";
import { promisify } from "util";
const exec = promisify(cExec);

// 用process.execPath代替"node"
const cmd = `${process.execPath} -v`;

const { stdout, stderr } = await exec(cmd);
if (stderr) throw new Error(stderr);
console.log(stdout);

修改后的测试2代码：

const { spawn } = require('node:child_process');

// 用process.execPath代替"node"
const ls = spawn(process.execPath, ['-v']);

ls.stdout.on('data', (data) => {
  console.log(`stdout: ${data}`);
});

ls.stderr.on('data', (data) => {
  console.error(`stderr: ${data}`);
});

ls.on('close', (code) => {
  console.log(`child process exited with code ${code}`);
});

方案2：指定node的完整绝对路径

如果你明确知道Node的安装路径（比如/usr/bin/node或/usr/local/bin/node），直接使用全路径调用：

// exec示例
const cmd = `/usr/bin/node -v`;

// spawn示例
const ls = spawn('/usr/bin/node', ['-v']);

方案3：修复子进程的PATH环境变量

在调用exec或spawn时，传入包含node所在目录的env参数，确保子进程能找到命令：

// exec示例
const { stdout, stderr } = await exec(cmd, {
  env: { ...process.env, PATH: `${process.env.PATH}:/usr/local/bin` }
});

// spawn示例
const ls = spawn('node', ['-v'], {
  env: { ...process.env, PATH: `${process.env.PATH}:/usr/local/bin` }
});

注意：将/usr/local/bin替换成你的Node实际安装目录。

方案4：尝试使用nodejs命令

如果是Debian/Ubuntu系系统，可能默认安装的可执行文件名为nodejs，可以替换命令尝试：

// exec示例
const cmd = `nodejs -v`;

// spawn示例
const ls = spawn('nodejs', ['-v']);

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