如何让python-bridge在Node.js（Electron）中识别Python虚拟环境包？

核心问题分析 #

你遇到的问题根源有两个：

1. python-bridge默认调用系统全局Python解释器，而非你创建的虚拟环境解释器，系统Python没有安装pandas依赖
2. 仅设置PYTHONPATH为venv根目录无效，因为Python包实际存放在虚拟环境的site-packages子目录中，根目录不是Python识别的包路径

解决方案 #

1. 直接指定虚拟环境的Python解释器路径

不要依赖PYTHONPATH，直接让python-bridge调用虚拟环境内的Python解释器，这样会自动加载该环境下的所有依赖。

根据系统平台拼接绝对路径（避免硬编码）：

const pythonBridge = require('python-bridge')
const path = require('path')

// 适配Windows/macOS/Linux的虚拟环境Python路径
const isWindows = process.platform === 'win32';
const venvPythonPath = isWindows 
    ? path.join(__dirname, 'venv', 'Scripts', 'python.exe')
    : path.join(__dirname, 'venv', 'bin', 'python3');

let python = pythonBridge({
    python: venvPythonPath
});

2. 确保虚拟环境内已安装所需依赖

激活虚拟环境后，重新安装依赖（避免装到全局Python）：

# Windows
venv\Scripts\activate
pip install pandas openpyxl

# macOS/Linux
source venv/bin/activate
pip install pandas openpyxl

注：openpyxl是pd.read_excel读取xlsx文件必需的依赖

3. 修复代码中的进程关闭时机

原代码中python.end()放在then外部，会导致Python进程提前关闭，引发执行错误。需将其移到then和catch回调内：

// 合并导入与函数定义，避免作用域分离问题
python.ex`
import pandas as pd

def read_data():
    return pd.read_excel('data.xlsx').to_json()
`

python`read_data()`
.then(df => {
    console.log(df)
    python.end(); // 执行完成后关闭进程
})
.catch(err => {
    console.error('执行失败:', err)
    python.end(); // 出错时也需关闭进程
})

4. 发布应用时的注意事项

• 打包Electron应用时，需将venv目录一起打包（配置electron-builder/packager的files规则，包含venv/**/*）
• 始终用__dirname动态拼接路径，不要写死本地绝对路径，避免发布后路径失效

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