Node.js使用spawn调用Python进程报ENOENT错误的原因

在Node.js环境中引入child_process模块，通过spawn方法拉起Python进程查询版本信息，实现代码如下：

const { spawn } = require('child_process');
const process = spawn('python', ['--version']);

执行node server2.js命令运行上述代码时，程序抛出未捕获的error事件，具体错误日志如下：

$ node server2.js 
node:events:346
      throw er; // Unhandled 'error' event
      ^

Error: spawn python ENOENT
    at Process.ChildProcess._handle.onexit (node:internal/child_process:282:19)
    at onErrorNT (node:internal/child_process:480:16)
    at processTicksAndRejections (node:internal/process/task_queues:81:21)
Emitted 'error' event on ChildProcess instance at:
    at Process.ChildProcess._handle.onexit (node:internal/child_process:288:12)
    at onErrorNT (node:internal/child_process:480:16)
    at processTicksAndRejections (node:internal/process/task_queues:81:21) {
  errno: -2,
  code: 'ENOENT',
  syscall: 'spawn python',
  path: 'python',
  spawnargs: [ '--version' ]
}

ENOENT是跨平台通用的系统错误码，含义是目标文件/目录不存在，对应到这个场景，就是Node.js的spawn方法按照当前进程的环境变量PATH检索可执行文件时，找不到名为python的程序，常见诱因有三类：

• 本地未安装Python运行环境，不存在对应可执行文件
• 安装Python时没有将Python安装目录添加到系统PATH环境变量，系统检索路径时找不到对应程序
• 本地安装的是Python 3.x版本，当前多数新版Linux发行版、macOS、Windows系统的Python3默认只注册python3命令，不会默认创建python的命令别名，调用python时自然匹配不到目标程序

还有一个容易踩的隐性坑：如果从GUI菜单直接打开IDE启动Node.js服务，IDE启动时加载的环境变量可能和独立终端的环境变量不一致，哪怕终端里能正常执行python命令，Node.js拉起的子进程里也可能检索不到对应路径。

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