Node.js调用Python脚本时遇ModuleNotFoundError：找不到numpy模块

问题现象 #

在VSCode中用Node.js的child_process模块调用Python脚本，明明已经执行pip install numpy且选择了正确的Python解释器，但运行时仍报错：

stderr: Traceback (most recent call last):
  File "C:\Users\user\ProjectFiles\backendServer\pythonScript.py", line 9, in <module>
    import numpy as np
ModuleNotFoundError: No module named 'numpy'

核心原因 #

Node.js通过spawn调用的Python解释器，和你安装numpy时使用的Python环境不一致。系统中可能存在多个Python版本（比如Python2/Python3、全局环境/虚拟环境），spawn('python', ...)默认调用的可能是未安装numpy的那个版本。

解决方案 #

1. 使用Python解释器的绝对路径 #

找到你安装numpy的那个Python解释器的完整路径：

• Windows：在VSCode的Python终端输入where python，找到对应版本的路径（比如C:\Users\user\AppData\Local\Programs\Python\Python311\python.exe）
• Mac/Linux：输入which python3获取路径

修改Node.js代码中的spawn参数，替换为绝对路径（注意Windows路径要转义反斜杠）：

const {spawn} = require('child_process');
// 替换成你的Python解释器绝对路径
const python = spawn('C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python311\\python.exe', ['pythonScript.py', 'one', 'two']);

dataToSend = '';
python.stdout.on('data', function (data) {
  console.log('Pipe data from python script ...');
  dataToSend = data.toString();
});

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

python.on('close', (code) => {
  console.log(`child process close all stdio with code ${code}`);
  console.log(dataToSend)
});

2. 虚拟环境场景处理 #

如果你的Python项目使用了虚拟环境：

• Windows：调用虚拟环境内的解释器，路径一般是项目目录\venv\Scripts\python.exe
• Mac/Linux：路径为项目目录/venv/bin/python3
  确保激活虚拟环境后执行过pip install numpy，再用这个路径替换spawn中的Python命令。

3. 验证环境一致性 #

可以先运行一段测试代码，确认Node调用的Python环境是否正确：

const {spawn} = require('child_process');
// 替换成你怀疑的Python路径
const testPython = spawn('python', ['-c', 'import sys; print("Python路径:", sys.executable); import pip; print("已安装包:", [p.name for p in pip.get_installed_distributions()])']);

testPython.stdout.on('data', (data) => {
  console.log(data.toString());
});

对比输出的Python路径和你手动运行Python时的路径，以及是否包含numpy，就能确认环境是否匹配。

附用户原始代码 #

Node.js代码 #

const {spawn} = require('child_process');
const python = spawn('python', ['pythonScript.py', 'one', 'two']);

dataToSend = '';
python.stdout.on('data', function (data) {
  console.log('Pipe data from python script ...');
  dataToSend = data.toString();
});

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

python.on('close', (code) => {
  console.log(`child process close all stdio with code ${code}`);
  console.log(dataToSend)
});

Python代码 #

import sys
print('First param:'+sys.argv[1])
print('First param:'+sys.argv[2])
print('print1')
import numpy as np
print('print2')

内容的提问来源于stack exchange，提问作者Yair Ohana Gilad