### 使用 PyInstaller 打包 Python 脚本和资源文件 为了将 `.py` 文件以及图像资源（如 `.jpg`）打包成单个可执行文件，可以利用 `PyInstaller` 工具来完成此操作。该工具能够处理第三方库的查找与集成工作[^1]。 #### 安装 PyInstaller 首先需要安装 PyInstaller 库： ```bash pip install pyinstaller ``` #### 准备项目结构 假设有一个简单的 Python 程序位于名为 `myapp.py` 的文件中，并且希望将其连同一些图片资源一并打包。项目的目录结构可能如下所示： ``` project/ │── myapp.py └── images/ └── logo.jpg ``` #### 修改脚本以加载静态资源路径 为了让生成的应用程序能够在运行时找到这些资源，在源代码里应当定义一种方法用于获取数据文件的位置。下面是一个例子函数，它能返回相对于当前应用程序位置的数据文件绝对路径： ```python import os import sys def resource_path(relative_path): """ 获取附加资源的绝对路径 """ base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__))) return os.path.join(base_path, relative_path) # 加载图片作为示例用途 image_file = resource_path('images/logo.jpg') print(f'Image path: {image_file}') ``` 上述代码片段展示了如何创建一个辅助函数 `resource_path()` 来计算给定相对路径对应的物理地址。这有助于确保无论是在开发环境中还是被打包后的独立应用内都能正确访问到所需的外部资源文件。 #### 创建 spec 文件指定额外选项 对于更复杂的场景，比如想要控制最终输出的形式或添加更多自定义设置，则可以通过编写 `.spec` 配置文件实现。通过命令行参数 `-F/--onefile` 可指示 PyInstaller 尝试构建单一可分发文件；而使用 `--add-data` 参数则允许向捆绑包加入任意类型的非 Python 数据文件。 例如要制作仅含一个 EXE 文件的产品版本并且附带所有必要的依赖项及图片资料，可以在终端输入以下指令来自动生成相应的配置文件模板： ```bash pyi-makespec --onedir --name=myapplication --add-data "images/*;images/" myapp.py ``` 这里的关键部分在于 `--add-data` 后面跟的是两个由分号隔开字符串——前者表示本地磁盘上的实际路径模式匹配规则，后者则是目标环境中的虚拟根目录名称。注意不同操作系统间路径分隔符差异：Windows 下应采用反斜杠 `\` 或双正斜杠 `\\` ，而在 Unix 类平台下只需单个正斜杠 `/` 即可。 #### 构建最终产品 最后一步就是基于之前准备好的一切正式开始编译过程了。只需要简单地调用一次带有适当参数的 `pyinstaller` 命令即可启动整个流程： ```bash pyinstaller myapp.spec ``` 成功之后会在同一级目录下的 `dist/myapplication/` 子文件夹里面发现所需的结果 —— 一个完整的 Windows 平台专用桌面应用程序，其中已经包含了原始 Python 源码及其所引用的一切二进制组件和多媒体素材。