JupyterLab扩展构建失败求助：执行build命令遇Node子进程错误

问题原因 #

核心问题是Node.js版本不兼容：JupyterLab 2.2.6属于旧稳定版本，仅支持Node.js 10.x至14.x系列。你当前使用的Node.js 20.12.2版本过高，导致webpack进程启动时触发EINVAL参数无效错误，最终引发构建失败。

修复步骤 #

1. 降级Node.js到兼容版本 #

在conda环境中安装适配的Node.js稳定版本（推荐14.21.3）：

conda install nodejs=14.21.3 -c conda-forge

2. 清理JupyterLab缓存与旧构建文件 #

清除残留的构建缓存和临时文件，避免干扰新构建流程：

jupyter lab clean

3. 重新执行构建命令 #

再次运行构建指令：

jupyter lab build --dev-build=False --minimize=False

4. 安装并启用ipywidgets扩展（若未完成） #

构建成功后，安装ipywidgets并关联JupyterLab扩展：

conda install ipywidgets
jupyter labextension install @jupyter-widgets/jupyterlab-manager

备选方案：新建干净的conda环境 #

如果现有环境依赖混乱，可直接创建仅包含必要依赖的新环境：

conda create -n jupyterlab_old python=3.8 nodejs=14.21.3 jupyterlab=2.2.6 ipywidgets -c conda-forge
conda activate jupyterlab_old
jupyter lab build

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