### 如何将包含依赖项的 Python 项目打包为可分发的包或独立执行文件 #### 使用 PyInstaller 进行打包 PyInstaller 是一种常用工具，可以将 Python 脚本及其所有依赖项打包成单个可执行文件。对于带有外部依赖文件（如配置文件、图片或其他资源）的项目，需要特别注意这些文件在打包过程中的处理方式。 当使用 PyInstaller 打包时，默认情况下它只会包含脚本本身以及通过 `import` 导入的模块[^1]。如果项目中有外部文件未被显式导入，则需要手动指定这些文件以便将其纳入最终的可执行文件中[^2]。 #### 添加外部文件到可执行文件 为了确保所有的外部文件能够正确地被打包并随同程序一起发布，可以通过命令行参数或者 `.spec` 文件来定义附加的数据文件。 ##### 方法一：通过命令行参数 `-a/--add-data` 可以直接在调用 PyInstaller 的时候利用 `--add-data` 参数添加数据文件。此方法适用于简单的场景下少量文件的需求： ```bash pyinstaller --onefile --add-data "path/to/source_file:path/in/bundle" your_script.py ``` > **注意**: 在 Windows 上路径之间的冒号应替换为分号 (`;`) ，即 `"source_file;dest_folder"` 形式[^3]。 例如，如果有名为 `config.json` 的配置文件位于项目的根目录，并希望其放置在同一位置作为运行的应用程序的一部分，则可以如下操作： ```bash pyinstaller --onefile --add-data "config.json;." main.py ``` ##### 方法二：修改 spec 文件 更复杂的设置可通过编辑由 PyInstaller 自动生成的 `.spec` 文件完成。首次运行不带任何特殊选项的 PyInstaller 后会产生一个对应的 `.spec` 文件。打开这个文件并将所需的额外资料加入其中： ```python from PyInstaller.utils.hooks import collect_data_files datas = [ ('path_to_your_resources', 'destination_in_bundle'), ] block_cipher = None a = Analysis( ['main.py'], pathex=['.'], binaries=[], datas=datas, hiddenimports=[], hookspath=[], runtime_hooks=[], excludes=[], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=block_cipher, ) pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher) exe = EXE(pyz,...) coll = COLLECT(...) ``` 上述代码片段展示了如何向分析阶段传递自定义数据列表 `datas` 。每条记录都是源路径和目标路径组成的元组形式[^5]。 #### 测试与验证 创建好可执行文件之后，在实际部署之前务必对其进行充分测试以确认功能无误。由于缺少必要的组件可能导致崩溃等问题，因此建议在一个干净环境中尝试启动生成好的应用程序——这意味着该机器不应预先存在开发版本所使用的库副本。 #### 备选方案 - Inno Setup 配合使用 除了单纯依靠 PyInstaller 来构建单一文件外，还可以借助第三方软件如 Inno Setup 制作完整的安装包。这种方式允许更加精细控制哪些附属品应该伴随主应用一同发送出去。 --- ###