PyExecJS 调用失败主因是未安装或未正确配置 Node.js；中文乱码、参数传入失败、undefined 返回值源于编码与序列化问题；异步代码不支持；模块依赖和 ES6 语法需手动处理；推荐改用 subprocess 直接调用 Node.js 以提升可控性与稳定性。
PyExecJS 调用失败：找不到 Node.js 或报 RuntimeError: Could not find a JavaScript runtime
PyExecJS 默认不自带 JS 运行时，它只是个桥接层，必须依赖系统已安装的 Node.js（或其他如 PhantomJS，但已淘汰）。常见错误是 pip install pyexecjs 后直接 import 就报错，根本没检查 Node.js 是否在 PATH 里。
- 先在终端运行
node -v，确认输出类似v18.17.0；没输出？说明 Node.js 没装或没加进环境变量 - Mac / Linux 用户如果用 nvm 管理 Node.js，注意 PyExecJS 启动的是新 shell，默认不加载 nvm 配置，
os.environ["PATH"]里可能不含~/.nvm/versions/node/...—— 解决办法是在 Python 脚本开头手动追加：import os<br>os.environ["PATH"] += ":/Users/yourname/.nvm/versions/node/v18.17.0/bin"
- Windows 用户注意：Node.js 安装时勾选了 “Add to PATH” 才有效；若用 Scoop 或 Chocolatey 安装，也需确认 bin 目录在系统 PATH 中
PyExecJS 执行 JS 报错：中文乱码、参数传入失败、undefined 返回值
PyExecJS 底层通过子进程启动 Node.js，stdin/stdout 是字节流，对编码和数据序列化很敏感。不是所有 JS 代码都能“原样扔进去就跑”，尤其含中文、JSON 对象或异步逻辑时。
- JS 字符串里含中文？确保 Python 侧用
u"..."（Python 2）或默认 Unicode（Python 3），且 JS 代码字符串本身以 UTF-8 编码传入 —— PyExecJS 内部会用sys.getdefaultencoding()做 decode，出问题时显式指定：ctx.eval("encodeURIComponent('你好')".encode("utf-8").decode("latin1"))（绕过自动 decode） - 想传 Python dict 给 JS 函数？别直接传，先用
json.dumps()转成 JSON 字符串，再在 JS 里JSON.parse()；反之 JS 返回对象也要JSON.stringify()后由 Pythonjson.loads()解析 - JS 里用了
setTimeout或fetch？PyExecJS 不支持异步等待，所有代码必须同步执行。把异步逻辑改造成同步（比如用crypto替代网络请求），或换nodejs subprocess+asyncio自行管理
替代方案对比：PyExecJS vs subprocess.run(["node", "-e", "..."])
PyExecJS 表面简单，实际隐藏了大量不可控行为：进程复用策略模糊、错误堆栈不透出、超时不可设、无法捕获 stderr。对加密 Token 这类关键逻辑，稳定性比“少写两行”更重要。
- 用
subprocess.run更可控：import subprocess<br>result = subprocess.run(<br> ["node", "-e", "console.log(JSON.stringify({token: require('./encrypt').gen() }))"],<br> capture_output=True, text=True, timeout=5<br>)<br>if result.returncode == 0:<br> token = json.loads(result.stdout)["token"] - PyExecJS 的
ExecJS.runtime.exec实际也是起 subprocess，但它把 stderr 吞掉了，出错只给一句模糊的Program exited with code 1；而自己调subprocess能直接看到 Node.js 报的SyntaxError: Unexpected token 'export'这类真实错误 - 性能上无差别 —— 两者都是每次调用都启新 Node.js 进程；若真要复用，得自己维护一个长期运行的 Node.js 子进程（用 socket 或 stdio 通信），PyExecJS 根本不支持
加密脚本跑不通：JS 依赖缺失、ES6 语法报错、require is not defined
PyExecJS 的 exec 和 eval 只执行裸 JS 字符串，不解析 require、不处理模块系统、不支持 import。你丢进去一个带 require("crypto") 的文件，它只会当普通字符串执行，然后报错。
立即学习“Python免费学习笔记（深入）”；
- 不要直接
ctx.eval(open("encrypt.js").read())—— 这等于把整个文件当表达式求值，require在顶层无效。正确做法是用ctx.eval注入函数定义，再用ctx.call调用：ctx.eval("""function genToken(data) { return require('crypto').createHash('sha256').update(data).digest('hex'); }""")<br>token = ctx.call("genToken", "hello") - JS 文件用了 ES6+ 语法（如箭头函数、解构）？Node.js 版本太低会报错。查清目标环境 Node.js 版本，必要时用 Babel 预编译，或改用兼容写法
- 加密逻辑依赖第三方 npm 包（如
js-md5）？PyExecJS 无法自动 resolve node_modules。要么把包源码复制进字符串，要么改用subprocess调用独立的node encrypt.js脚本（该脚本自行require）
