### 在树莓派系统中使用 PyInstaller 将 Python 程序打包为可执行文件的方法 在树莓派系统中将 Python 程序打包为可执行文件，可以使用 PyInstaller 工具完成。以下是具体的操作步骤和注意事项： #### 1. 确认系统环境 确保树莓派的 Linux 系统内核版本、Python 版本以及 PyInstaller 版本兼容。例如，树莓派使用的 Raspbian 系统内核版本为 `Linux raspberrypi 5.15.84-v7l`（表示 32 位），Python 使用版本为 `3.9.2`，PyInstaller 使用版本为 `5.5`[^1]。 #### 2. 安装 PyInstaller 在树莓派上安装 PyInstaller 的步骤如下： - 下载 PyInstaller 安装包，可以从官网 [pyinstaller.org](https://www.pyinstaller.org) 获取。 - 解压缩安装包后进入解压后的目录。 - 使用以下命令以管理员权限安装 PyInstaller： ```bash sudo su python3 setup.py install ``` - 验证安装是否成功，运行以下命令检查版本号： ```bash pyinstaller -v ``` #### 3. 打包单个 `.py` 文件 对于单个 `.py` 文件的打包，可以使用以下命令： ```bash pyinstaller your_script.py -F ``` 其中，`your_script.py` 是需要打包的 Python 文件名，`-F` 参数表示将所有依赖打包成一个单独的可执行文件。打包完成后，生成的可执行文件会存放在 `dist` 目录下[^2]。 #### 4. 打包多个 `.py` 文件 如果需要打包多个 `.py` 文件，首先需要将这些文件整合到一个主脚本中，或者通过入口脚本引用其他模块。然后运行以下命令进行打包： ```bash pyinstaller main_script.py --hidden-import=module_name -F ``` 其中，`main_script.py` 是主脚本文件名，`--hidden-import=module_name` 参数用于显式导入未被自动检测到的模块[^1]。 #### 5. 处理常见错误 在树莓派上使用 PyInstaller 打包时可能会遇到以下错误： - **致命错误：PyInstaller 不包含适用于当前平台的预编译引导程序** 错误信息为： ``` Fatal error: PyInstaller does not include a pre-compiled bootloader for your platform. ``` 解决方法是手动编译引导程序。进入 PyInstaller 源码目录中的 `bootloader` 文件夹，运行以下命令： ```bash cd bootloader python ./waf distclean all ``` 编译完成后重新尝试打包[^3]。 #### 6. 注意事项 - 确保 PyInstaller 的版本支持当前的 Python 版本。例如，PyInstaller 5.8.0 只支持 Python 3.7 及以上版本。 - 如果打包过程中出现依赖问题，可以通过 `--hidden-import` 参数显式导入缺失的模块。 - 打包完成后，建议在目标平台上测试生成的可执行文件是否正常运行。 ```python # 示例代码：简单的 Python 脚本 def hello_world(): print("Hello, World!") if __name__ == "__main__": hello_world() ```