Node.js环境下安装TensorFlow.js失败的问题求助

问题核心分析 #

从报错日志可定位两个关键问题：

1. 预编译二进制包缺失：@tensorflow/tfjs-node@4.16.0针对Node.js 18.12.1的预编译包不存在（返回404），安装过程回退到源码编译。
2. 源码编译依赖缺失：Python 3.12默认不再包含distutils模块，导致node-gyp编译时抛出ModuleNotFoundError: No module named 'distutils'。

解决方案 #

1. 修复Python distutils缺失问题 #

Python 3.12已移除默认的distutils模块，需手动补充：

• 打开命令提示符执行：

  pip install setuptools
  

  （setuptools包含distutils的替代实现，可满足node-gyp编译需求）
• 若上述命令无效，重新运行Python 3.12安装程序，勾选**"Python distutils"**可选组件后完成安装。

2. 解决预编译包不匹配问题 #

针对预编译包404的问题，可任选以下一种方案：

• 方案一：降级Node.js版本
  切换到@tensorflow/tfjs-node@4.16.0官方支持的稳定Node.js版本（比如Node.js 16.x），再重新执行安装命令。
• 方案二：安装兼容的tfjs-node版本
  选择与Node.js 18.12.1匹配的tfjs-node版本，例如：

  npm install @tensorflow/tfjs-node@4.14.0
  

• 方案三：强制使用CPU预编译包
  设置环境变量强制拉取CPU版本的预编译包，再执行安装：

  set TFJS_NODE_CPU_ONLY=1
  npm install @tensorflow/tfjs-node
  

3. 清理缓存后重新安装 #

执行以下步骤确保安装环境干净：

1. 清理npm缓存：

   npm cache clean --force
   

2. 删除项目目录下的node_modules文件夹和package-lock.json文件：

   rmdir /s /q node_modules
   del package-lock.json
   

3. 重新执行安装命令。

关于旧版本v2.8.4的说明 #

v2.8.4版本过旧，与Node.js 18.x存在兼容性问题，即使安装成功也会出现运行时构建错误，不建议使用。

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