### 解决方案 当使用 PyInstaller 扛鼎应用时，如果环境中存在多个 Qt 绑定包（如 `PySide2` 和 `PyQt5`），可能会触发错误提示： `SystemExit: Aborting build process due to attempt to collect multiple Qt bindings packages...`[^3]。 此问题的根本原因是 PyInstaller 不支持在同一冻结的应用程序中包含多种 Qt 绑定包。因此，在构建过程中需要确保只有一种 Qt 绑定被加载到最终的可执行文件中。 以下是具体的解决方案： #### 方法一：卸载多余的 Qt 绑定 可以通过移除不需要的 Qt 绑定来解决问题。例如，如果你决定仅保留 `PyQt5`，可以运行以下命令卸载 `PySide2` 或其他冲突的绑定： ```bash pip uninstall PySide2 -y ``` 同理，如果你想保留 `PySide2` 而排除 `PyQt5`，则应运行： ```bash pip uninstall PyQt5 -y ``` 通过这种方式清理环境中的多余依赖项能够有效避免冲突[^2]。 #### 方法二：手动排除模块 如果不希望更改全局 Python 环境，则可以在 PyInstaller 命令行参数中指定要排除的模块。例如，为了排除 `PyQt5` 并仅保留 `PySide2`，可以这样操作： ```bash pyinstaller your_script.py --exclude-module=PyQt5 --noconsole ``` 同样地，若想排除 `PySide2` 并专注于 `PyQt5` 的话，只需调整上述命令为： ```bash pyinstaller your_script.py --exclude-module=PySide2 --noconsole ``` 这种方法允许你在不修改基础安装的情况下灵活控制哪些模块参与打包过程[^4]。 #### 方法三：编辑 `.spec` 文件实现更精细配置 对于复杂项目来说，直接通过 CLI 参数可能不够精确；此时建议先生成一个 spec 配置文件再做进一步定制化设置。具体步骤如下所示： 1. **创建初始 Spec 文件** 运行下面这条指令来自动生成适合当前项目的 spec 文件模板： ```bash pyinstaller your_script.py --name="YourAppName" ``` 2. **打开并修改该 Spec 文件** 定位至 `[Analysis(...)]` 部分找到其内部定义好的列表变量——比如叫做 `excludes` 的那个数组结构体对象那里追加上我们想要忽略掉的相关库名称字符串值进去即可完成目标设定工作啦！像这样的样子呈现出来会更好看一些哦～比如说我现在打算把刚才提到过的那两款竞争关系比较明显的图形界面开发框架都给屏蔽出去的话就可以这么写咯： ```python ... excludes=['PyQt5', 'PySide2'], ... ``` 最后保存改动后的版本重新提交回去让工具按照新的指示去处理整个编译流程吧！ --- ### 总结代码示例 这里提供一段完整的基于方法二的手动排除模块的例子供参考： ```bash pyinstaller your_script.py --exclude-module=PyQt5 --exclude-module=PySide6 --noconsole --add-data "your_path;ultralytics/cfg" ``` 以上方式均能有效地帮助开发者规避由多套相互独立却又彼此排斥性质强烈的 GUI 工具集所引发的一系列兼容性难题。 --- ###