2025年Python安装运行mayavi过程全记录

本文从新建干净环境python 3.7说起，需安装文件有

PyQt4-4.11.4, traits-6.3.1, VTK-8.1.2, mayavi-4.7.3, PyQt5, VisualStudio

一、下载对应版本的.whl文件

https://pypi.tuna.tsinghua.edu.cn/simple/

1. 必须按照顺序依次安装 PyQt4-4.11.4, traits-6.3.1，VTK-8.1.2，mayavi-4.7.3
   
   PyQt4-4.11.4-cp37-cp37m-win_amd64.whl 需先解压，traits-6.3.1-cp37-cp37m-win_amd64.whl ，vtk-8.1.2-cp37-cp37m-win_amd64.whl ，mayavi-4.7.3.tar.gz

pip install PyQt4-4.11.4-cp37-cp37m-win_amd64.whl
pip install traits-6.3.1-cp37-cp37m-win_amd64.whl
pip install vtk-8.1.2-cp37-cp37m-win_amd64.whl
pip install mayavi-4.7.3.tar.gz

其中如果安装mayavi卡住，说明上述安装版本不对应，主要是VTK不要到9.0.0以上

PyQt4,traits,VTK安装成功如下：

mayavi安装成功如下（warning是网络有点问题，重新安装就好）：

1. 测试代码

from mayavi import mlab
import numpy as np
# 创建一个简单的 3D 曲面
x, y = np.mgrid[-10:10:100j, -10:10:100j]
z = np.sin(x**2 + y**2) / (x**2 + y**2 + 1e-6)  # 避免除以零
# 绘制 3D 曲面
mlab.surf(x, y, z, warp_scale="auto", colormap="cool")
# 添加标题和颜色条
mlab.title("Mayavi Test Plot")
mlab.colorbar(title="Height", orientation="vertical")
# 显示图形
mlab.show()

测试报错，革命尚未成功，可能以前这样就可以，但是笔者时间节点是2025.07不可以了。

需要再下载PyQt5

二、安装PyQt5

1. 从清华源上直接下载PyQt5

pip install pyqt5 pyqt5-tools -i https://pypi.tuna.tsinghua.edu.cn/simple

再次报错 Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools"，

需要下载并安装VisualStudioBuildTools

1. 下载并安装VisualStudioBuildTools
   
   打开powershell，从源直接下载，一共8G要等一会

wget https://aka.ms/vs/17/release/vs_BuildTools.exe -o vs_BuildTools.exe ; cmd /c vs_BuildTools.exe

安装时注意下面两图勾选即可

1. 再次下载安装pyqt5

pip install pyqt5 pyqt5-tools -i https://pypi.tuna.tsinghua.edu.cn/simple

Congratulations 成功运行！！！