PyInstaller打包动态插件时的命令参数配置

在使用 PyInstaller 进行项目打包时，若项目中涉及动态加载的库或插件，需特别注意配置相应的命令行参数，以保证这些动态组件能够顺利地被打包进最终的可执行文件中。

主要涉及到的两个关键参数为：--hidden-import 和 --add-binary。

• --hidden-import : 用于指定那些在代码中通过动态方式导入但未直接出现在 import 语句中的模块名。这对于确保这些隐藏的模块能够被 PyInstaller 发现并包含在最终的打包文件中至关重要。
• --add-binary : 用于添加二进制文件或数据文件到打包的应用程序中。这里的 src 是源文件路径，dest 是目标路径，即文件在打包后的应用中所处的位置。在 Windows 系统中，路径分隔符使用分号 (;)，而在 Linux 系统中则使用冒号 (:)。

假设你的项目结构如下：

| - main.py
| - plugins/
| - plugins/__init__.py
| - plugins/_01plugin.py
| - plugins/_02plugin.py
| - plugins/_98plugin.py
| - plugins/_99plugin.py

你可以使用以下命令进行打包：

pyinstaller --hidden-import=_01plugin --hidden-import=_02plugin --hidden-import=_98plugin --hidden-import=_99plugin --add-binary=./plugins/__init__.py;plugins --add-binary=./plugins/_01plugin.py;plugins --add-binary=./plugins/_02plugin.py;plugins --add-binary=./plugins/_98plugin.py;plugins --add-binary=./plugins/_99plugin.py;plugins -F main.py

其中，-F 参数表示将整个项目打包成单个 .exe 文件。

即使正确配置了上述参数，有时仍可能遇到“找不到动态插件”的错误。这是因为 PyInstaller 打包的 .exe 文件在运行时会先将内部资源解压到一个临时目录（如 Windows 下的 %TEMP% 或 Linux 下的 /tmp），而程序默认查找的是当前工作目录下的资源文件。因此，需要在代码中动态确定资源文件的实际路径，确保无论是在开发环境还是打包后的环境中都能正确访问资源文件。

import sys
import os

base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
plugins_path = os.path.join(base_path, 'plugins')

上述代码段首先尝试获取 _MEIPASS 属性，该属性在打包后的 .exe 文件运行时会被设置为临时解压目录的路径。如果没有设置（即在开发环境中运行），则使用当前文件所在的目录作为基础路径。接着，构建出插件目录的完整路径，从而解决了资源文件路径的问题。

单独使用 --hidden-import 或 --add-binary 都可能导致不同的问题：仅使用 --hidden-import 可能会导致缺少必要的文件资源；而仅使用 --add-binary 则可能因未能识别某些动态导入的模块而导致运行时错误。因此，两者通常需要结合使用。