### 解决方案 当使用 PyInstaller 构建应用程序时，如果环境中同时存在多个 Qt 绑定（如 PyQt5 和 PyQt6），可能会触发错误并中断构建过程。这是因为 PyInstaller 不支持在同一应用中混合使用多种 Qt 绑定[^1]。 为了防止此类问题发生，可以通过以下方法排除多余的 Qt 绑定： #### 方法一：通过命令行选项 `--exclude` 排除多余绑定 可以在运行 PyInstaller 命令时指定 `--exclude` 参数来排除不需要的模块。例如，如果希望仅保留 PyQt5，则可以执行如下命令： ```bash pyinstaller your_script.py --exclude-module=PySide6 --exclude-module=PyQt6 ``` 此操作会告诉 PyInstaller 忽略 `PySide6` 和 `PyQt6` 模块，从而避免冲突[^2]。 #### 方法二：修改 `.spec` 文件以排除多余绑定 另一种方式是编辑由 PyInstaller 自动生成的 `.spec` 文件，在其中定义 `excludes` 列表。具体步骤如下： 1. 使用 `pyi-makespec` 创建初始 `.spec` 文件： ```bash pyi-makespec your_script.py ``` 2. 打开生成的 `.spec` 文件，并找到 `Analysis` 部分中的 `excludes` 字段。 3. 修改该字段以排除不必要的模块。例如： ```python a = Analysis( ['your_script.py'], pathex=['.'], binaries=[], datas=[], hiddenimports=[], hookspath=[], hooksconfig={}, runtime_hooks=[], excludes=["PySide6", "PyQt6"], # 添加这一行 win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None, ) ``` 保存更改后，重新运行 PyInstaller 并指定 `.spec` 文件作为输入： ```bash pyinstaller your_script.spec ``` #### 方法三：卸载不使用的 Qt 绑定 如果确认项目只需要一种特定的 Qt 绑定（如 PyQt5 或 PyQt6），可以直接从环境中移除其他绑定。例如： - 卸载 `PySide6`： ```bash pip uninstall PySide6 ``` - 卸载 `PyQt6`： ```bash pip uninstall PyQt6 ``` 完成上述操作后再尝试打包即可消除冲突[^3]。 --- ### 注意事项 在某些情况下，即使已采取措施排除多余绑定，仍可能出现文件读取或写入失败的情况。这可能是由于缺少必要的资源文件所致[^4]。建议检查项目的依赖项以及是否正确配置了数据路径。 --- ### 示例代码片段 以下是基于 `.spec` 文件的方法实现的一个简单例子： ```python from PyInstaller.utils.hooks import collect_submodules, collect_data_files a = Analysis( ['main.py'], pathex=['.'], binaries=[], datas=collect_data_files('your_module'), hiddenimports=collect_submodules('your_module'), hookspath=[], hooksconfig={}, runtime_hooks=[], excludes=["PySide6", "PyQt6"], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None, ) pyz = PYZ(a.pure, a.zipped_data, cipher=None) exe = EXE(pyz,...) # 完整参数省略 coll = COLLECT(exe,...) # 完整参数省略 ``` ---