PyInstaller打包后出现No module named错误的技术求助

针对你遇到的直接运行Python脚本正常，但打包成exe后找不到lib1和lib2的问题，核心原因是PyInstaller的静态分析机制和打包后的隔离环境特性，以下是几种可行的解决方法：

方法1：打包时指定额外导入路径 #

PyInstaller依赖静态分析识别导入模块，直接动态修改sys.path不会被其识别。打包时用--paths参数显式告知需要扫描的目录，确保模块被打包进exe：

# 从folder/src目录执行打包命令
pyinstaller --paths ../.. --paths ../../libs main.py

../..对应root目录，../../libs对应root/libs目录，这样PyInstaller能扫描到lib1和lib2并打包。

方法2：调整导入方式并修改.spec文件 #

1. 调整代码中的导入语句为PyInstaller可静态识别的形式：
   • 对于同目录的lib1，使用相对导入：from . import lib1
   • 对于lib2，使用包导入：from libs import lib2
2. 生成并修改.spec文件：
   先执行pyinstaller main.py生成main.spec，打开后修改Analysis部分的pathex和hiddenimports：

   a = Analysis(
       ['main.py'],
       pathex=['/root', '/root/libs', '/root/folder/src'],
       binaries=[],
       datas=[],
       hiddenimports=['lib1', 'lib2'],
       # 其他参数保持不变
   )
   

   然后用pyinstaller main.spec重新打包。

方法3：适配打包后的路径逻辑 #

PyInstaller打包后运行时的工作目录和路径结构与本地开发环境不同，需针对打包环境调整sys.path的设置：

import sys
import os

def setup_path():
    if getattr(sys, 'frozen', False):
        # 打包后的临时运行目录
        base_dir = sys._MEIPASS
    else:
        # 本地开发环境的root目录
        base_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
    
    # 添加需要的路径
    sys.path.append(base_dir)
    sys.path.append(os.path.join(base_dir, 'libs'))
    sys.path.append(os.path.join(base_dir, 'folder', 'src'))

setup_path()

# 之后再执行导入
import lib1
import lib2

这种方式能确保无论是本地运行还是打包后运行，sys.path都能正确指向模块所在目录。

内容的提问来源于stack exchange，提问作者m4lou