将VPython2.7脚本转Windows EXE时遇visual模块缺失错误求助

问题根源 #

VPython 2.7的visual模块属于旧版本专属库，打包工具（如PyInstaller、py2exe）默认无法自动识别其特殊的模块结构，导致打包时遗漏该模块，运行EXE时触发ModuleNotFoundError。

解决步骤 #

1. 确认本地环境依赖 #

• 先验证Python 2.7环境中是否已正确安装VPython：运行命令

  python -c "import visual; print('visual模块导入成功')"
  

  若报错，需下载适配Python 2.7的VPython旧版本安装包完成安装（注意不要安装3.x版本的vpython，两者不兼容）。

2. 使用PyInstaller打包（推荐方案） #

PyInstaller对旧模块兼容性更好，需安装适配Python 2.7的版本：

• 安装PyInstaller：

  pip install pyinstaller==3.6
  

• 打包时强制指定导入visual模块，避免遗漏：

  pyinstaller --hidden-import=visual --onefile 你的脚本文件名.py
  

• 若仍报错，手动指定visual模块的安装路径（先通过python -c "import visual; print(visual.__path__)"获取路径）：

  pyinstaller --hidden-import=visual --paths=C:\Python27\Lib\site-packages\visual --onefile 你的脚本文件名.py
  

3. 修正示例代码中的错误 #

你的示例代码中变量f1未定义，直接打包运行会崩溃，修正后代码如下：

from visual import*
from time import*
from math import*
L1=0.1
H1=2.8
W1=4.0
W1=0.1
W2=0.0
T1=.15
L1 = 6
a1=-H1/2
b1=H1/2
c1=L1/2
d1=-L1/2
e1=W1/2
f1 = -e1  # 补充定义f1变量
floor=box(pos=vector(0,a1,0),color=color.white,length=L1,height=T1,width=W1+T1)
right=box(pos=vector(c1,0,0),color=color.orange,length=T1,height=H1,width=W1)
left=box(pos=vector(d1,0,0),color=color.white,length=T1,height=H1,width=W1)
behind=box(pos=vector(0,0,e1),color=color.white,length=L1+T1,height=H1,width=T1)
front=box(pos=vector(0,0,f1),color=color.white,length=L1+T1,height=H1,width=T1)

4. 测试打包结果 #

打包完成后，在生成的dist文件夹中找到EXE文件，双击运行：

• 若正常弹出3D窗口并显示模型，说明打包成功；
• 若仍提示子模块缺失，查看PyInstaller日志，将遗漏的子模块（如visual.vector、visual.color）加入--hidden-import参数重新打包。

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