### 如何使用 PyInstaller 的 `--onefile` 模式并添加隐藏依赖模块 当使用 PyInstaller 打包 Python 脚本为单个可执行文件时，可以通过 `--onefile` 参数实现此功能。如果脚本中有未被自动检测到的隐藏依赖模块，则可以利用 `--hidden-import` 参数手动指定这些模块。 以下是具体的操作方法： #### 使用命令行参数的方式 通过在命令行中提供 `--onefile` 和 `--hidden-import` 参数来完成打包操作。假设需要包含名为 `your_module` 的隐藏模块，完整的命令如下所示[^1]： ```bash pyinstaller --onefile --hidden-import=your_module your_program.py ``` 上述命令会将 `your_program.py` 打包成一个单独的可执行文件，并确保 `your_module` 作为隐藏依赖被正确嵌入其中。 #### 如果遇到 `.spec` 文件错误的情况 需要注意的是，在已经存在 `.spec` 文件的情况下，直接运行带有 `--onedir` 或 `--onefile` 参数的命令可能会引发错误提示：“options not allowed: –onedir/–onefile makespec options not valid when a .spec file is given”[^2]。此时应修改现有的 `.spec` 文件而不是重新生成新的命令。 对于这种情况，可以在 `.spec` 文件中的 `Analysis` 部分增加对应的隐含导入设置。例如： ```python from PyInstaller.utils.hooks import collect_submodules a = Analysis(['your_program.py'], pathex=['.'], binaries=[], datas=[], hiddenimports=['your_module'], # 添加此处 hookspath=[], runtime_hooks=[], excludes=[], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=None) ``` 保存更改后的 `.spec` 文件后，再调用 PyInstaller 并指向该文件即可正常工作。 --- ### 示例代码片段 以下是一个简单的例子展示如何应用以上配置： ```python # 假设这是要被打包的应用程序入口 main.py import some_hidden_module def run(): print("Running the application...") if __name__ == "__main__": run() ``` 对应打包指令为： ```bash pyinstaller --onefile --hidden-import=some_hidden_module main.py ``` 或者编辑 spec 文件后执行： ```bash pyinstaller main.spec ``` ---