### 如何使用 `--add-data` 参数将文件或文件夹嵌入到可执行文件中 在使用 PyInstaller 打包 Python 脚本时，可以通过 `--add-data` 参数指定额外的资源文件（如图片、配置文件或其他依赖项），并将它们嵌入到最终生成的 `.exe` 文件中。以下是关于该参数的具体说明以及如何正确使用的指南。 #### 基础语法 `--add-data` 的基本语法如下： ```bash pyinstaller [其他选项] --add-data '<源路径>;<目标路径>' <脚本名> ``` - `<源路径>` 是指本地磁盘上的实际文件或文件夹位置。 - `<目标路径>` 是指打包后，在运行时解压出来的相对路径[^1]。 注意：不同操作系统下分隔符可能有所不同。Windows 平台使用分号 (`;`) 分隔源路径和目标路径，而 macOS 和 Linux 则使用冒号 (`:`)[^2]。 #### 示例代码 假设有一个名为 `format_conversion.py` 的脚本需要打包成单个可执行文件，并且希望将其所需的图标文件 `use_ico.png` 添加进去，则可以按照以下方式操作： 对于 Windows 用户： ```bash pyinstaller -F --add-data 'use_ico.png;./' format_conversion.py ``` 对于 macOS 或 Linux 用户： ```bash pyinstaller -F --add-data 'use_ico.png:./' format_conversion.py ``` 上述命令中的 `-F` 表示生成单一文件模式下的 EXE 可执行程序；`--add-data` 后面的内容定义了要添加的数据及其存储的目标路径。这里 `'use_ico.png;./'` 指定了将当前目录下的 `use_ico.png` 图标复制到应用启动时创建的工作目录根部。 如果想加入整个文件夹而不是单独的一个文件，比如把一个叫作 `resources` 的文件夹加进来，那么同样可以根据平台差异调整命令形式： 针对 Windows 系统： ```bash pyinstaller -F --add-data 'resources;resources/' your_script.py ``` 面向 Unix-like 系统则应写为： ```bash pyinstaller -F --add-data 'resources:resources/' your_script.py ``` 这会使得 `resources` 这一整套子结构得以保留并随同应用程序一起部署。 #### 访问已嵌入的文件 当通过 `--add-data` 加载外部数据之后，在运行期间需利用特定逻辑来定位这些附加资料的位置。这是因为 PyInstaller 在执行过程中可能会改变工作目录或者重新安排内部布局的缘故。下面给出了一种通用做法用于获取任意附加文档的实际地址： Python 中实现此功能的一段示范代码可能是这样的： ```python import sys import os def resource_path(relative_path): """ 获取附加资源的真实路径 """ try: # PyInstaller 创建了一个临时文件夹 BASE_PATH 存储所有解压缩后的资产 base_path = sys._MEIPASS except Exception: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) # 使用函数加载图像或者其他类型的附件 icon_file = resource_path('use_ico.png') print(f"The icon file is located at {icon_file}") ``` 以上片段展示了怎样安全可靠地检索由 `--add-data` 插入至最终产物里的任何种类档案的确切所在处所。 ---