如何使用pyinstaller打包Anaconda安装的paraview程序

问题根本原因 #

PyInstaller无法自动识别ParaView的两类依赖：

• 隐式导入的内部模块（包括报错提到的_paraview_modules_static、paraview.modules.*下的所有VTK扩展模块）
• 绑定的原生动态库、配置资源、插件文件，手动复制模块仅覆盖了Python层代码，缺失原生依赖和路径配置。

具体操作步骤 #

1. 生成并修改PyInstaller配置文件 #

首先运行一次基础命令生成main.spec配置文件：

pyi-makespec main.py

打开生成的main.spec，替换内容如下（注意替换{miniconda_root}为本地miniconda的根目录路径）：

# -*- mode: python ; coding: utf-8 -*-
import os
paraview_path = os.path.expanduser("{miniconda_root}/miniconda3/lib/python3.9/site-packages/paraview")

block_cipher = None

a = Analysis(
    ['main.py'],
    pathex=[],
    binaries=[
        # 收录paraview所有原生动态库
        (os.path.join(paraview_path, "*.dylib"), "paraview"),
        (os.path.join(paraview_path, "modules", "*.dylib"), "paraview/modules"),
    ],
    datas=[
        # 收录整个paraview目录的资源和Python代码
        (paraview_path, "paraview"),
    ],
    hiddenimports=[
        # 显式声明缺失的隐式导入模块
        "_paraview_modules_static",
        "paraview.modules.vtkPVVTKExtensionsCore",
        # 自动补全所有paraview.modules下的模块
        *[f"paraview.modules.{f.split('.')[0]}" for f in os.listdir(os.path.join(paraview_path, "modules")) if f.endswith(".py") or f.endswith(".dylib")]
    ],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
    noarchive=False,
)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)

exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='main',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    console=True,
    disable_windowed_traceback=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)
coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='main',
)

2. 基于修改后的配置文件执行打包 #

pyinstaller main.spec --clean

3. MacOS额外适配处理 #

如果打包完成后运行仍有权限或动态库加载报错，执行以下命令修正路径和签名：

# 替换为你本地打包生成的目录路径
cd {MyPackage_root}/dist/main
# 修正动态库加载路径
install_name_tool -add_rpath @executable_path/paraview main
# 本地签名绕过公证限制（仅本地运行可用，对外分发需要正式开发者签名）
codesign --force --deep --sign - main

验证 #

运行dist/main/main即可正常启动程序，生成圆锥可视化窗口。

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