多Python文件打包为可执行程序失败求助：PyInstaller/auto-py-to-exe问题

1. 先抓崩溃的具体错误 #

别直接双击exe，打开命令提示符，cd到exe所在目录，运行你的程序名.exe，把报错信息记下来——比如是ModuleNotFoundError还是FileNotFoundError，这是定位问题的关键。

2. 检查utils的导入与打包配置 #

• 如果报错是找不到utils模块：
  • 试试在打包命令里加--hidden-import utils，强制PyInstaller把这个模块打包进去。比如：

    pyinstaller main.py --hidden-import utils --add-data "utils.py;." --add-data "resources/*.txt;resources/"
    

  • 要是用了相对导入（比如from .utils import xxx），改成绝对导入import utils，打包时相对导入容易出问题。

3. 确认--add-data的路径格式 #

自动填充的参数可能格式错了：

• Windows下路径分隔用分号;，比如"utils.py;."表示把utils.py放到exe同目录；"resources/*.txt;resources/"表示把txt文件放到exe目录下的resources文件夹里。
• 打包后去exe所在目录看看，有没有utils.py和resources文件夹，文件是不是都在。

4. 适配PyInstaller的临时运行路径 #

PyInstaller运行exe时会把文件解压到临时目录（比如_MEIxxxxxx），代码里的相对路径会失效。给main.py加个获取真实路径的函数，所有涉及文件的地方都用它：

import sys
import os

def get_real_path(relative_path):
    # 打包后取临时目录路径，没打包就取当前目录
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

比如读取resources里的文件：

file_path = get_real_path("resources/xxx.txt")

要是utils导入还是有问题，把utils的路径加入sys.path：

sys.path.append(get_real_path("."))
import utils

5. 用spec文件手动配置 #

自动打包参数不靠谱的话，先生成spec文件：

pyinstaller main.py --name 你的程序名 --add-data "utils.py;." --add-data "resources/*.txt;resources/" --hidden-import utils

打开生成的你的程序名.spec，检查datas和hiddenimports部分是否正确：

datas = [('utils.py', '.'), ('resources/*.txt', 'resources')]
hiddenimports = ['utils']

然后用spec文件重新打包：

pyinstaller 你的程序名.spec

6. 排查utils里的隐藏依赖 #

如果utils里用了PyInstaller没自动检测到的第三方库，也要用--hidden-import把这些库加进去。比如utils里用了pandas但打包时没包含，就加--hidden-import pandas。

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