Windows下pip安装crystal_toolkit失败 crystaltoolkit-extension报错

核心报错原因 #

crystaltoolkit-extension==0.6.0 版本原生打包配置存在Windows平台兼容缺陷，叠加本地构建依赖版本过高、Windows默认路径长度限制两个触发条件，就会出现wheel构建阶段子进程退出、无法生成remoteEntry.*.js静态文件的报错，现有pip源、代理、超时配置均无问题，无需调整。

按优先级选择修复方案 #

方案1：安装兼容版本跳过本地构建（成功率最高） #

直接安装已提供Windows预编译wheel包的稳定版本，全程不需要本地执行构建流程，不会触发setuptools弃用警告、路径不存在类报错：

• 新建干净的conda虚拟环境，指定兼容的Python版本（3.8~3.10，高于3.10的版本无兼容二进制包）

  conda create -n ctk python=3.9 -y
  conda activate ctk
  

• 清理本地pip缓存，避免之前下载的损坏源码包重复触发错误

  pip cache purge
  

• 执行安装命令固定兼容版本

  pip install crystal-toolkit==2023.8.18 crystaltoolkit-extension==0.5.1
  

方案2：修复构建环境后安装0.6.0版本 #

如果必须使用0.6.0版本特性，按以下步骤修复本地构建环境后再安装：

• 按方案1的步骤创建Python 3.9的虚拟环境、清理pip缓存
• 固定构建依赖版本，规避高版本setuptools的弃用兼容问题

  pip install setuptools==65.5.0 nodejs wheel jupyter-packaging==0.12.3
  

• 开启Windows长路径支持，解决构建时深层嵌套路径无法创建文件的问题：
  • 按下Win+R输入regedit打开注册表编辑器
  • 定位到路径计算机\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
  • 找到LongPathsEnabled项，将数值改为1，重启电脑生效
• 执行安装命令跳过npm自动构建步骤

  pip install crystal-toolkit crystaltoolkit-extension==0.6.0 --no-build-isolation
  

• 安装完成后手动执行JupyterLab扩展构建补全静态资源

  jupyter lab build
  

避坑说明 #

• 不要在Anaconda base环境直接安装，base环境预装的包版本冲突概率极高
• 不需要反复调整pip.ini的源、代理配置，现有配置可以正常拉取安装包
• 不要使用Python 3.11及以上版本安装，对应版本没有适配的依赖二进制包

内容的提问来源于stack exchange，提问作者Marco Di Gennaro