<think>嗯，用户遇到了PyInstaller打包时出现"No module named"错误的问题，特别针对自己编写的类模块。从引用内容看，用户已经查阅了一些解决方案，但可能对自定义模块的处理还有困惑。 用户应该是在打包包含自定义模块的项目时遇到了问题。这类问题通常比第三方库缺失更棘手，因为PyInstaller无法自动检测用户自己编写的模块路径。用户可能已经尝试过--hidden-import等常见方案但未奏效。 从技术角度看，需要分三个层面解决： 首先是路径问题，自定义模块不在标准库路径时，打包后执行环境会丢失这些路径引用。解决方案是在代码中动态添加路径，或者用sys._MEIPASS处理冻结后的路径。 其次是打包命令需要显式包含模块目录。PyInstaller的-p参数可以指定多个搜索路径，这对多级目录结构特别重要。用户可能需要递归添加所有包含自定义模块的父目录。 最后是导入方式的影响。相对导入在打包后容易失效，建议用户改用绝对导入。如果模块有动态导入情况，还需要在spec文件中添加hook。 用户可能没意识到的是：当自定义模块存在嵌套导入时，需要确保所有层级都被包含。比如主模块导入utils.log，那么utils和utils.log都需要处理。另外如果模块在子目录且缺少__init__.py，也会导致识别失败。 考虑到用户是开发者，回复应该包含具体代码示例和参数用法。特别要强调路径设置的两种方法（运行时添加vs打包参数），因为这是自定义模块问题的核心。还要提醒测试建议，毕竟这类问题可能需要反复调试。 安全方面注意：动态修改sys.path的代码示例要标注清楚作用范围，避免用户误用在生产环境。路径拼接也要提示os.path的使用，防止跨平台问题。 </think> 针对PyInstaller打包后执行时出现 **`No module named`（导入自定义类模块）** 的问题，以下是经过验证的解决方案： --- ### 解决方法 #### 1. **添加模块搜索路径（关键步骤）** 在**主入口文件**开头添加以下代码，显式声明自定义模块的路径： ```python import sys from pathlib import Path # 获取当前文件所在目录的父目录（项目根目录） BASE_DIR = Path(__file__).resolve().parent sys.path.append(str(BASE_DIR)) # 添加根目录到模块搜索路径 # 若模块在子目录（如 utils/） sys.path.append(str(BASE_DIR / "utils")) # 添加子目录路径 ``` #### 2. **打包时指定模块路径** 使用 `-p` 参数显式指定自定义模块的路径（可叠加多个）： ```bash pyinstaller -F -p ./utils -p ./models 你的主程序.py ``` * **`-p ./utils`**：将 `utils` 目录加入模块搜索路径 * **`-p ./models`**：将 `models` 目录加入模块搜索路径 #### 3. **检查导入语句** 确保导入自定义类时使用**绝对导入**（推荐）： ```python # 正确示例（从项目根目录开始） from utils.my_class import MyClass from models.data_processor import DataProcessor # 错误示例（相对导入在打包后易失效） # from .utils.my_class import MyClass # 避免! ``` --- ### 完整打包命令示例 ```bash pyinstaller -F \ -p ./src/utils \ # 指定自定义模块目录 -p ./src/models \ # 指定其他模块目录 --hidden-import="your_module" \ # 可选：显式隐藏导入 主程序.py ``` --- ### 常见问题排查 1. **目录结构问题** 确保自定义模块目录包含 `__init__.py` 文件（可为空），使其成为有效Python包。 2. **路径动态生成** 若路径在运行时动态生成（如 `os.getcwd()`），需替换为： ```python import sys, os if getattr(sys, 'frozen', False): # 打包后环境 BASE_DIR = sys._MEIPASS # 使用临时解压目录 else: BASE_DIR = os.path.dirname(__file__) ``` 3. **嵌套导入失效** 若自定义模块中导入了其他第三方库，需额外添加 `--hidden-import`： ```bash pyinstaller -F ... --hidden-import="numpy" --hidden-import="pandas" ``` --- ### 引用说明 > PyInstaller 对自定义模块的路径检测能力有限，需手动指定路径。动态添加 `sys.path` 是最可靠的解决方案，确保打包后仍能定位到本地模块[^3][^4]。 ---