### 使用 PyInstaller 添加依赖文件的方法 当使用 PyInstaller 打包 Python 应用程序时，有时会遇到应用程序所需的额外资源未被打包的情况。这可能包括图像、配置文件或其他类型的静态数据文件。 #### 方法一：通过命令行参数指定附加文件 可以直接在调用 `pyinstaller` 命令的时候利用 `--add-data` 参数来添加必要的依赖文件。对于 Windows 平台而言，路径分隔符应采用分号(`;`)连接源文件与目标位置[^2]： ```bash pyinstaller --add-data "source_file_path;destination_folder" your_script.py ``` 例如，如果有一个名为 `config.txt` 的配置文件位于项目的根目录，并希望将其放置于生成的应用程序同一级，则可以这样做: ```bash pyinstaller --add-data "config.txt;." main.py ``` #### 方法二：编辑 spec 文件定义数据文件 另一种更灵活的方式是创建或修改 `.spec` 文件，在其中显式声明要包含的数据文件列表。这种方式允许更加精细地控制哪些文件应该被包含以及它们最终的位置[^4]。 假设已经存在一个由 PyInstaller 自动生成的 `your_project_name.spec` 文件，可以在该文件内的 `Analysis` 对象部分增加如下内容以引入外部资源： ```python a = Analysis(['main.py'], pathex=[], binaries=[], datas=[ ('path/to/source/file', 'target/directory'), # (src, dst) ... ], hiddenimports=[], hookspath=[], runtime_hooks=[], excludes=[], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=block_cipher, noarchive=False) pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher) exe = EXE(pyz, a.scripts, [], exclude_binaries=True, name='your_project_name', debug=False, strip=False, upx=True, console=True ) coll = COLLECT(exe, a.binaries, a.zipfiles, a.datas, strip=False, upx=True, upx_exclude=[], name='your_project_name') ``` 在此基础上调整 `'path/to/source/file'` 和 `'target/directory'` 来匹配实际需求即可完成自定义设置。 #### 注意事项 - 如果打包后的应用体积异常庞大，可能是由于包含了不必要的库或是重复版本的动态链接库(DLL)，此时应当审查项目结构并优化导入语句减少冗余项[^3]。 - 当工作在一个跨平台环境中开发时，请注意不同操作系统间路径表达方式的区别，比如 Linux/macOS 下使用冒号(:), 而Windows则需使用分号(;)作为分隔符[^5]。