安装ijavascript失败，zeromq模块触发npm报错如何解决

错误根因 #

安装ijavascript时抛出npm code 1错误，报错路径指向ijavascript/node_modules/zeromq目录，本质是ijavascript依赖的zeromq模块在当前环境下默认触发本地源码编译流程，因编译依赖缺失、Anaconda虚拟环境路径映射冲突导致编译中断。常规排查用到的降级Python、升级npm、全新环境重装、添加环境变量等操作未命中核心问题，按以下步骤操作即可修复：

首选方案：跳过源码编译，安装预构建二进制包（适配90%以上同类报错场景） #

• 激活目标conda虚拟环境：

  conda activate jsenv
  

• 修改npm全局配置，强制优先拉取zeromq官方发布的预编译二进制文件，禁用本地源码编译逻辑：

  npm config set zeromq_prebuild_binary true
  npm config set build_from_source false
  

• 提前单独安装兼容版本的zeromq依赖：必须安装5.x版本（推荐5.2.8），6.x及以上版本存在API不兼容问题，会导致ijavascript安装完成后无法正常运行：

  npm install zeromq@5.2.8
  

• 待zeromq安装完成后，执行ijavascript全局安装命令：

  npm install -g ijavascript
  

• 安装完成后执行ijsinstall完成Jupyter内核注册，即可正常调用ijavascript内核。

备选方案：补全本地编译依赖链（首选方案无效时使用） #

• 以管理员身份打开终端，安装Windows平台Node.js原生模块所需的完整编译工具链：

  npm install -g windows-build-tools
  

• 在已激活的conda虚拟环境中，安装zeromq编译依赖的系统库：

  conda install -c conda-forge zeromq libsodium
  

• 执行npm cache clean --force清理历史安装缓存，删除之前安装失败残留的node_modules目录，重新执行ijavascript安装命令即可。

注意事项 #

• 禁止在Anaconda base环境中安装Node.js全局包，该环境的路径映射冲突概率极高，必须使用独立虚拟环境操作
• 若当前Node.js版本为18及以上，需切换到16.x LTS长期支持版本，zeromq 5.x对18+版本Node.js的预编译包适配不全，会强制触发本地编译流程
• 安装全程无需使用管理员权限运行终端，普通用户权限激活对应虚拟环境后操作即可，管理员权限会导致路径识别、权限映射异常，提升报错概率。

内容的提问来源于stack exchange，提问作者Parth Sethi