pyinstaller打包运行报错failed to execute script main

最新推荐文章于 2025-03-27 23:36:43 发布

脚本之家

最新推荐文章于 2025-03-27 23:36:43 发布

阅读量2.7w

点赞数 15

分类专栏：程序人生

本文链接：https://blog.csdn.net/jearmy/article/details/89575705

版权

最近使用PyQT5开发一个桌面应用程序，单独运行没有问题，但是使用打包工具pyinstaller打包后，却弹出窗口，提示“failed to execute script main”。
pyinstaller的版本为最新，python为V3.7，配合QT版本5.3

问题现象

使用pyinstaller打包后，运行exe就会提示错误，“failed to execute script main”。但是代码本地调是没有问题的。如图

解决办法

这个问题，我经过百度，也没找到最终的解决办法。最后通过自己的尝试，最终解决问题。现在总结一下遇到这类问题应如何处理，以免日后再次掉坑里。
可根据以下列举项进行排查：

排查1，是不是打包过程中出问题

如果打包过程中，本身就出错了，那即使生成了可执行文件，肯定也不能运用。因此，注意检查一下，打包的log。
如何检查呢？一种是通过查看打包命令的回显，另外也可以在打包生成的文件夹里查看，有个html格式的文件会记录打包过程的log。
打包过程中，常见的错误有：

ImportError: C extension: No module named *
这类问题，可以增加--hidden-import 选项进行屏蔽。
代码目录结构不合理，打包时出错

排查2，代码本身有问题

主要是路径的问题。例如：脚本中需要在当前路径下创

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

脚本之家

关注关注

15
点赞
踩
60

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Pyinstaller 打包 failed to execute script main 兼容 32 位系统

July树树

03-24

766

在使用 Pyinstaller 兼容 32 位打包一个命令行程序时遇到 failed to execute script main，原始的执行代码为 pyinstaller -F -w main.py 执行后报错 failed to execure script main，检查后发现是因为 -w 参数造成的问题，-w 参数用于使用 Windows 子系统执行，程序启动时不会打开命令行，在新版本 python 会忽略这个参数，不影响正常执行，而 python 3.6 则会报错，解决方法也很简单，去掉 -w

Python：pyinstaller 打包运行.exe报错 failed to execute script ***

liangxin20082557的专栏

08-06

768

Python：pyinstaller 打包运行.exe报错 failed to execute script ***

参与评论您还未登录，请先登录后发表或查看评论

Failed to execute script main 错误

leshen_88的博客

06-18

5052

使用pyinstaller打包一个程序.使用了pyinstaller -F -w main.py。运行程序的时候出"Failed to execute script main"错误检查代码中是否有数据库连接，且没有被用上，数据导入没有被使用等都有可能导致该错误。这是我当时是这样错的，然后这样解决的，你们可以借鉴一下！ ...

linux如何在终端启动程序并让其在后台执行

weixin_41554427的博客

03-27

399

在终端启动程序并让其在后台执行，可根据不同的使用场景，采用以下几种常见方法。

pyinstaller打包python文件后，运行出现"Failed to execute script xxx.exe"错误的解决方式(No module named 'xxx')

热门推荐

qq_42063091的博客

09-05

9万+

一、问题定位： windows+r进入cmd命令行窗口 cd exe文件所在路径；如cd C:\Users\user\Desktop\test\dist 执行命令行：xxx.exe 参数1 参数2（无参数可忽略）我这里报的错是说字符串类型不能使用乘法，在python里没有转类型也是可以用的，但这里需要用int()转一下 ...

python fail to execute_【Python】pyinstaller打包运行报错failed to execute script main

weixin_39894778的博客

12-09

607

前言最近用pyinstaller打包的时候一直报“failed to execute script main”。最终使用“pyinstaller --hidden-import=pkg_resources -F main.py” 顺利打包。注意：语句中的“-F”一定要大写转载原文pyqt5写完win32 应用程序后，经过pyinstaller打包成单个文件，运行弹出错误提示框：failed to ...

使用pyinstaller打包后，运行exe就会提示错误，“failed to execute script main”

weixin_49229860的博客

03-06

2827

问题使用pyinstaller打包后，运行exe就会提示错误，“failed to execute script main”。但是main.py在cmd里面运行是没有问题的。解决这个问题，我查了很多博客，也没找到最终的解决办法。最后通过自己的尝试，最终解决问题。原因是因为，在此之前，我将anaconda 的jupyter notebook的默认起始路径进行了修改：默认路径修改后会带来一系列的问题，比如pip/conda没法安装库总是报错。因此，我将anaconda卸载重装了一遍，再次打包文件

Pyinstaller打包exe，常见报错 “failed to execute script XXX“的解决方案之一

weixin_48157735的博客

05-18

3156

我的项目是用python写一个人脸识别系统，我这里出现这个错误的原因是因为封装的内容缺少了需要的文件，解决方法很简单。（不想看前面部分可以直接查看第3步） 1.封装时使用的命令：在你需要封装的程序所属文件夹中打开cmd 然后执行命令：pyinstaller -D login.py 1.1 命令解读使用-D可以除了生成exe程序外，还能生成许多描述文件与文件夹。如果你使用的是-F 或者 -w命令的话，也可以生成exe程序，但是如果出现此类报错，需要修改的文件夹位置在C盘（我这里是显示修改C盘），因此，

pyinstaller打包exe软件并解决 Pyinstaller failed to execute script main问题（用了sklearn库）

明日复明日的博客

06-27

2082

一、基本的操作 pyinstaller -F --noconsole ***.py -n 软件名字 -i 1.ico -F 参数是打包后，只留下一个.exe的可执行文件默认情况下的参数是 -D 打包后在dist目录有多个依赖文件（但是用D启动会快一些） –noconsole 参数是运行时不显示控制台的意思，一般是 -w ，但是我w无法运行（注意这里两个–不是手误） -n 另外还可以使用 -n *** 的方式确定exe的文件名，如 -n 我的第一个exe程序 -i 显然是icon图标二、出现问题 Pyi

Failed to execute script Main

goujimin的博客

09-28

9013

项目场景：Failed to execute script Main 解决pycharm中打包程序的错误问题描述：打包后显示成功，但是不能使用今天讲述一下本人被一个问题折磨了整整三天的艰苦历程。基于python和PyQt5写了一个串口调试助手的小程序，在打包程序的过程中出现了以下的错误。首先安装pyinstaller ，命令如下， pip install pyinstaller 命令框显示成功，但是.eve文件不能运行，提示Failed to execute script M

failed to execute script 解决方案+命令行执行传参exe

09-19

failed to execute script 解决方案+命令行执行传参exe

运行exe文件时弹出“Failed to execute script main”

IrisZang的博客

08-26

2万+

问题描述在运行一个之前打包好的python程序时，弹出“Failed to execute script main”，如下图所示，导致程序无法正常运行。问题验证与分析：（1）该exe可执行文件之前执行正常；（2）百度同样的问题，有这样的回答“检查一下代码里有没有 input，如果代码里有 input语句，而打包时又使用了 -w选项时就会出现这个错误。”（https://www.jianshu.com/p/8697ad3425b0），检查源码并没有使用input；（3）按第（2）条中建议修.

pyinstaller failed to execute script XXX

目标检测、LLM相关

03-25

1985

解决pyinstaller failed to execute script XXX问题

python打包成exe文件，运行弹窗出现 failed to execute script main，can‘t find package Tix问题

shiGXW的博客

07-07

3143

解决办法一：打包附带额外py库–hidden-import=tix 打包时加上 --hidden-import=tix 命令行打包示例： pyinstaller --hidden-import=tix -w -F main.py 或 pyinstaller.exe -w -F --hidden-import=tix main.py 解决办法二：打包附带额外资源–add-data=…tix8.4.3;tix8.4.3 打包时加上 --add-data=D:\python38\tcl\tix8.4.3

Pyinstaller failed to execute script main

Sherlock_Holmes_lv的博客

05-31

712

相信看这篇文章的同学肯定折腾了很久，不急，慢慢来首先如果你没有打包之前运行是没问题的话，那基本就是资源（图片）在打包过程中的引用问题先不要用“pyinstaller -F” 用 “pyinstaller -D” 然后进入到main.exe所在目录使用命令行运行main.exe，这样我们能看到所报的错误。然后根据错误该导入资源的导入。但是我发现报了些莫名其妙的错误，原因竟然是项目的上层目录中包含有与这个项目相同文件名的文件，移除这些就可以了 .spec的使用： .spec的使用 ...

Pygame在用pyinstaller时报错，Failed to execute scripts Main

The_RedMaple的博客

05-18

1474

前几天做好了飞机大战的游戏，准备把它用pyinstaller打包起来。结果打包好了后，很开心的一打开居然给我报错了，内容如下：Failed to execute scripts Main. 这我就懵了呀，我可是第一次用pyinstaller呀。这个样子报错我马上去网上千查万查，参数数十种办法，不是瞎说，这办法我就尝试了没有三十次也有二十次了。我用了差不多8个小时也没有成功，人真的是要崩溃了。正当我要放弃的时候，我看见了网上一个说法，他说先写一个简单的小游戏，然后尝试一下会不会出现问题，如果没有问题，那么

pyinstaller-Failed to execute script main解决

weixin_30455067的博客

08-04

764

使用pyinstaller打包一个程序.使用了pyinstaller -F -w main.py. 运行程序的时候出"Failed to execute script main"错误. 查看了下对应文件夹内的文件,没有发现log或者其他文件,也没有调试信息. 想来想去,换了个命令pyinstaller -F -c main.py,使用控制台模式,打包后,运行,还是一闪而过. 但是有错误信息...

【已解决】Python打包成exe.后无法访问程序所在的路径 No such file or directory:[27168] Failed to execute script ‘main‘ d

qq_58407247的博客

10-30

3645

介绍由于python打包成exe后无法访问exe所在的相对路径的问题导致报错 No such file or directory: Failed to execute script 'main' due to unhandled exception! 的原因与解决方案

使用pyinstaller打成exe之后报如下错误：Traceback (most recent call last): File "main.py", line 2, in <module> ModuleNotFoundError: No module named 'kotei_agent' [PYI-20924:ERROR] Failed to execute script 'main' due to unhandled exception!

最新发布

04-03

<think>好的，我现在需要解决用户在使用PyInstaller打包成exe后遇到的ModuleNotFoundError问题，具体是找不到'kotei_agent'模块。首先，我得回忆一下常见的导致这种情况的原因以及相应的解决方法。首先，用户遇到的错误提示是模块未找到，这说明在生成的exe文件中，PyInstaller没有正确包含该模块。可能的原因有几个： 1. **模块未正确安装或路径问题**：'kotei_agent'可能是一个第三方库，但未正确安装，或者是一个本地模块，不在Python的标准库路径中。PyInstaller在打包时可能无法自动检测到本地模块，尤其是当它们不在项目目录或标准的site-packages中时。 2. **PyInstaller的钩子问题或隐藏导入**：有时候PyInstaller无法自动识别某些导入，特别是动态导入或位于非标准位置的模块。这时候需要手动指定隐藏导入（--hidden-import）或者使用钩子文件（hook）来告诉PyInstaller包含这些模块。 3. **路径问题在打包后的环境中**：打包后的exe运行时，工作目录可能与开发时不同，导致模块的路径未被正确引用。需要确保在代码中正确设置了模块的路径，或者在打包时包含数据文件或路径。接下来，我需要按照步骤来引导用户解决问题： **第一步：确认模块存在**：用户需要确认是否在开发环境中能够正常导入'kotei_agent'模块。如果这是一个本地模块，确保它位于项目目录中，或者在打包时被正确包含。 **第二步：检查PyInstaller命令**：用户可能没有正确指定需要包含的模块。建议用户在打包命令中添加--hidden-import=kotei_agent，或者使用.spec文件来配置。 **第三步：处理路径问题**：如果模块位于非标准路径，可能需要使用--paths参数指定模块所在的目录，或者在代码中添加sys.path.append()语句。 **第四步：检查模块的依赖**：如果'kotei_agent'有其他依赖，这些依赖也需要被打包进去，否则同样会出现模块未找到的错误。 **第五步：调试打包过程**：建议用户使用--debug选项重新打包，或者生成.spec文件进行详细配置，确保所有需要的文件都被包含进去。在用户的具体案例中，如果'kotei_agent'是一个本地模块，可能需要确保在打包时将其作为数据文件包含，或者调整代码中的导入路径。此外，检查模块是否存在拼写错误或大小写问题，尤其是在区分大小写的文件系统中。总结下来，用户需要逐步排查模块的安装情况、PyInstaller的配置选项、路径设置以及依赖项，从而找到导致模块无法被正确包含的原因，并采取相应的措施解决。</think>### 问题分析出现`ModuleNotFoundError: No module named 'kotei_agent'`的常见原因有： 1. **模块未安装**：`kotei_agent`未正确安装到Python环境。 2. **路径未包含**：模块位于项目目录外的自定义路径，PyInstaller未自动识别。 3. **动态导入**：模块在代码中被动态导入（如`importlib`），PyInstaller无法静态分析。 4. **打包配置缺失**：未通过`.spec`文件或命令行参数显式声明依赖。 --- ### 逐步解决方案 #### 第一步：确认模块存在 1. 在开发环境中直接运行脚本，确认能正常导入`kotei_agent`。 2. 检查`kotei_agent`的安装情况： ```bash pip list | grep kotei_agent ``` - 若未安装，通过`pip install`或源码安装。 - 若是本地模块，确保文件路径在`sys.path`中。 --- #### 第二步：调整PyInstaller打包命令 1. **显式声明隐藏导入**： ```bash pyinstaller --hidden-import=kotei_agent main.py ``` - 若模块有嵌套结构（如`kotei_agent.submodule`），需完整声明。 2. **添加模块搜索路径**： ```bash pyinstaller --paths="/path/to/kotei_agent" main.py ``` - 替换`/path/to/kotei_agent`为模块实际路径。 --- #### 第三步：使用.spec文件配置（推荐） 1. 生成初始`.spec`文件： ```bash pyi-makespec main.py ``` 2. 修改`.spec`文件： ```python a = Analysis( ['main.py'], pathex=['/path/to/kotei_agent'], # 添加模块路径 hiddenimports=['kotei_agent'], # 声明隐藏导入 ... ) ``` 3. 重新打包： ```bash pyinstaller main.spec ``` --- #### 第四步：检查动态导入问题如果代码中存在类似动态导入： ```python module_name = "kotei_agent" module = __import__(module_name) ``` 需在打包时显式声明所有可能的动态导入模块。 --- #### 第五步：验证打包结果 1. 解压生成的exe文件检查依赖： ```bash # 进入exe所在目录 cd dist/main # 解压可执行文件（Windows需安装7-zip） 7z x main.exe ``` 2. 检查`PYZ-00.pyz`或`base_library.zip`中是否包含`kotei_agent`模块。 --- ### 其他注意事项 1. **虚拟环境问题**：确保打包时使用的Python环境与开发环境一致。 2. **路径硬编码**：避免代码中使用绝对路径，改用`sys._MEIPASS`处理资源文件： ```python import sys import os if getattr(sys, 'frozen', False): base_path = sys._MEIPASS else: base_path = os.path.dirname(__file__) config_path = os.path.join(base_path, 'kotei_agent') ``` 3. **更新PyInstaller**：使用最新版本避免已知问题： ```bash pip install --upgrade pyinstaller ``` --- ### 总结流程图 ```plaintext 确认模块存在 → 调整打包命令 → 使用.spec文件 → 检查动态导入 → 验证结果 ↑_______________若失败_________________| | 检查环境/路径问题 ``` 按上述步骤操作后，通常能解决模块未找到的问题。如果仍报错，请提供`kotei_agent`的代码结构或导入方式，以便进一步分析。