Pyinstaller生成的可执行文件运行异常：空白CMD窗口秒关求助

这种情况我之前碰过好多次，大概率是打包时的控制台设置问题，或者程序打包后出现了隐性报错导致窗口直接闪退。给你几个实用的解决思路：

1. 打包时禁用控制台窗口（适合GUI程序） #

如果你的程序是带界面的GUI应用，直接在打包命令里加上-w或--windowed参数，告诉PyInstaller不要生成控制台窗口：

pyinstaller -w your_script.py

要是你的程序需要依赖控制台输出内容，那这个方法就别用了，先看下面的排查方式。

2. 让控制台窗口保持打开，查看报错信息 #

窗口闪退最常见的原因是程序运行时抛出了异常，但控制台窗口直接关闭你看不到错误。可以用这两种方式留住窗口：

• 手动打开CMD，切换到exe所在的文件夹，然后直接输入exe文件名运行，这样即使出错，窗口也不会自动关闭，你能看到具体的报错内容。
• 或者在你的Python脚本末尾加上一段等待输入的代码，打包后运行时窗口会停住，直到你按回车才关闭：

  # 放在脚本最后
  input("按回车键退出...")
  

  这种方式能帮你快速定位到底是哪里出了问题，比如缺失依赖、路径错误之类的。

3. 检查脚本中的路径问题 #

很多时候原脚本用python file.py能正常运行，但打包后就出错，都是因为用了相对路径导致的。比如脚本里写了open("./config.ini")，打包后exe的工作目录可能和你预期的不一样，找不到文件。

你可以改成用绝对路径来获取文件，比如：

import os
# 获取当前脚本/exe所在的绝对目录
current_dir = os.path.dirname(os.path.abspath(__file__))
# 拼接目标文件的路径
config_path = os.path.join(current_dir, "config.ini")
# 再用这个路径去打开文件
with open(config_path, "r") as f:
    pass

这样不管exe放在哪里运行，都能正确找到依赖的文件。

4. 用调试模式打包，查看详细日志 #

如果上面的方法都没解决，你可以用调试模式重新打包，获取更详细的日志信息，排查打包过程中有没有异常：

pyinstaller --debug=all your_script.py

日志里会显示打包时的每一步操作，包括依赖项的收集情况，能帮你发现一些隐性问题。

先试试前两个方法，尤其是查看报错信息这一步，大部分情况下都能快速找到问题根源。

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