pyinstaller 打包后，运行时找不到自定义的模块

这种情况一般是因为 PyInstaller 没有正确地识别你的自定义模块。你可以尝试以下几个方法来解决这个问题：

1. 在打包命令中加入 `--hidden-import=your_module` 参数，这样 PyInstaller 就会在打包时将该模块打包进去。

2. 在主程序中手动添加自定义模块的路径，例如：

import sys
sys.path.append('/path/to/your/module')

这样就可以让 Python 运行时找到你的模块。

3. 如果你的自定义模块依赖其他第三方库，你需要在打包时加入这些依赖库，例如：

pyinstaller your_program.py --hidden-import=your_module --hidden-import=dependency_module

其中 `dependency_module` 是你的自定义模块所依赖的第三方库。

希望这些方法能够帮助你解决问题。

相关问题

pyinstaller打包后看不到文件

### PyInstaller 打包后文件不可见的解决方案

当使用 `PyInstaller` 进行 Python 应用程序打包时，可能会遇到打包后的可执行文件无法正常显示资源文件的情况。这通常是因为资源文件未被正确包含在最终的打包文件中。

#### 方法一：修改 spec 文件手动指定要包含的文件
如果直接使用命令行参数 `-F -w main.py` 可能会覆盖默认生成的 `.spec` 文件[^1]。建议先通过以下方式创建并编辑 `.spec` 文件：

pyi-makespec your_script.py

打开生成的 `your_script.spec` 文件，在其中找到 `a = Analysis(...)` 部分，添加需要包含的数据文件列表:

datas=[('path/to/your/resource', 'destination_folder')]

保存更改后再运行构建过程：

pyinstaller your_script.spec

这种方法可以精确控制哪些额外文件应该被打包进去以及它们的目标位置。

#### 方法二：利用钩子机制自动处理依赖关系
对于某些特定库或框架（如 PyQt），可以通过编写自定义挂钩来让 PyInstaller 自动识别所需的隐藏导入和其他资源。具体做法是在项目根目录下新建一个名为 `hooks` 的文件夹，并在里面放置相应的 hook 脚本。

另外，也可以尝试更新至更高版本的 PyInstaller (例如 3.3+) ，因为不同版本间可能存在语法差异[^3]，新版本可能已经修复了一些已知问题并且改进了对各种第三方模块的支持程度。

#### 方法三：调整工作路径设置
有时应用程序启动时的工作目录并不是预期的位置，从而导致找不到相对路径下的资源文件。可以在代码内部显式设定当前工作目录为应用所在位置：

import os
import sys

if getattr(sys, 'frozen', False):
    application_path = sys._MEIPASS
else:
    application_path = os.path.dirname(os.path.abspath(__file__))
os.chdir(application_path)

这段代码确保无论是在开发环境还是经过 PyInstaller 处理之后的应用环境中都能正确访问本地资源。

pyinstaller打包卡死

### PyInstaller 打包过程中出现卡死问题的原因分析

当使用 PyInstaller 将 Python 脚本打包成可执行文件时，如果遇到程序不断开启新进程并最终导致系统资源耗尽的情况，通常是由以下几个原因引起的：

- **多线程或多进程处理不当**：Python 的 `multiprocessing` 或者其他并发库可能会在打包后的环境中表现异常。这可能是由于 PyInstaller 默认会将所有依赖项打包到单个 EXE 文件中，在某些情况下会影响子进程的启动方式[^1]。

- **隐式模块导入失败**：有时项目中使用的第三方库可能不会被自动检测出来，从而造成运行时错误或行为不一致。特别是对于那些动态加载模块的应用来说更为常见[^4]。

- **路径配置问题**：打包后的应用程序内部相对路径解析可能出现偏差，特别是在访问外部资源（如配置文件、数据集等）时容易引发意想不到的行为变化[^3]。

### 解决方案建议

针对上述提到的各种可能性，可以采取如下措施来尝试解决问题：

#### 修改代码结构以适应打包环境
为了确保打包后的应用能够正常工作，应该尽量减少对外部资源绝对路径的依赖，并且尽可能显式声明所需的所有依赖关系。可以通过调整源码中的文件读取逻辑以及设置合理的默认参数值等方式实现这一点。

#### 使用 `-D` 参数代替 `-F`
考虑采用目录模式(`-D`)而非单一文件模式(`-F`)来进行打包操作。这样做可以让各个组件之间的交互更加透明可控，有助于排查潜在冲突点。同时也能方便调试期间查看具体哪个部分出现了异常情况。

python -m PyInstaller -i logo.ico -D -p ./console -n scl_runner ./main.py

#### 添加必要的钩子(Hooks)
通过编写自定义 Hook 来帮助 PyInstaller 正确识别和包含特定于项目的额外资源或特殊类型的对象。这对于涉及复杂的数据交换机制或是调用了 C/C++ 库扩展功能的情形尤为重要。

#### 更新至最新版本
保持所用工具链处于最新状态往往能有效规避许多已知缺陷带来的麻烦。因此推荐定期检查官方仓库是否有新的发布版可用，并及时升级本地安装副本。