Python 3.10导入PyVista时出现VTK导入错误如何解决

这个导入错误由PyVista与环境内VTK版本不匹配直接导致：

• vtkExtractEdges在VTK 9.1及更早版本中归属于vtkmodules.vtkFiltersExtraction模块，VTK 9.2之后该类被迁移到vtkmodules.vtkFiltersCore模块
• 直接执行pip install pyvista时，pip的依赖解析可能拉取和当前PyVista版本不匹配的VTK包，导入时就会出现找不到对应类的问题
• 少数情况是之前通过apt、多次pip安装残留了多版本VTK，Python导入时加载了错误版本的动态链接库文件

按优先级尝试以下方案，第一种方案能解决90%以上的同类问题：

方案1：清理残留后安装固定兼容版本 #

先彻底卸载现有PyVista和VTK的所有安装残留，再安装经过兼容性验证的版本组合：

1. 多次执行卸载命令，确保所有版本都被清除：

   pip uninstall -y pyvista vtk
   pip uninstall -y pyvista vtk
   

2. 安装适配Ubuntu22.04默认Python3.10环境的版本组合：

   pip install vtk==9.2.6 pyvista==0.42.3
   

3. 执行验证命令，无报错即为修复完成：

   python -c "import pyvista; print('PyVista导入成功，版本：', pyvista.__version__)"
   

方案2：使用虚拟环境隔离全局依赖 #

如果全局Python环境安装包过多存在版本冲突，新建干净虚拟环境安装即可：

# 在家目录创建虚拟环境
python3 -m venv ~/pv-env
# 激活虚拟环境
source ~/pv-env/bin/activate
# 虚拟环境内直接安装PyVista，会自动拉取匹配的VTK依赖
pip install pyvista

后续运行涉及PyVista的代码前，先执行source ~/pv-env/bin/activate激活环境即可。

方案3：使用系统源预适配的安装包 #

如果不想手动管理版本，可以直接用Ubuntu官方源做过兼容性校验的包，彻底避免版本匹配问题：

# 先清除pip安装的残留包
pip uninstall -y pyvista vtk
# 安装系统源适配版本
sudo apt update
sudo apt install -y python3-pyvista python3-vtk

安装完成后直接导入即可，不需要额外处理依赖。

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