使用pip安装bfieldtools与mayavi包时卡在构建wheel阶段如何解决

故障根本原因 #

pip默认会优先尝试从源码构建wheel包，Mayavi源码编译依赖完整的C++编译环境、以及对应依赖的头文件匹配，Python 3.9+版本与默认拉取的最新Mayavi源码存在版本适配问题，会导致编译流程无限卡住。

可行解决步骤 #

• 强制拉取预编译二进制包跳过本地编译：
  执行如下命令，该参数会要求pip仅拉取匹配当前环境的预编译包，无需本地编译，正常1分钟内即可完成安装
  pip install --only-binary :all: mayavi
• 如提示无匹配包，先修复pip版本适配问题：
  你当前使用的pip 21.2.4版本存在旧版预编译包识别异常问题，先降级pip到兼容版本后重试即可
  pip install pip==20.3.4
pip install --only-binary :all: mayavi
• 适配现有VTK版本指定安装：
  你当前已安装VTK 9.0.3，与之完全兼容的Mayavi版本为4.7.1，可指定版本安装避免版本冲突
  pip install --only-binary :all: mayavi==4.7.1

安装验证 #

执行如下命令，正常输出版本号即为安装成功：
python -c "import mayavi; print(mayavi.__version__)"

内容的提问来源于stack exchange，提问作者Yoav Tarazy