PyInstaller打包的exe启动后空白闪退问题求助

第一步：先获取错误信息（最关键） #

闪退的核心是运行时出错，但控制台窗口直接关闭看不到错误，用以下两种方式获取报错内容：

• 方法1：从命令行启动exe
  打开cmd，切换到exe所在文件夹，输入你的exe文件名.exe并回车，控制台不会自动关闭，能直接看到具体报错信息，这是最快定位问题的方式。
• 方法2：在脚本里添加错误捕获日志
  在脚本主逻辑外层包裹try-except，把错误写入日志文件，示例代码：

  import traceback
  import sys
  
  def main():
      # 你的原有脚本逻辑：处理氨基酸序列、计算分子描述符的代码
      pass
  
  if __name__ == "__main__":
      try:
          main()
          # 正常结束时添加输入等待，防止闪退
          input("程序执行完成，按回车退出...")
      except Exception as e:
          with open("error_log.txt", "w", encoding="utf-8") as f:
              f.write(traceback.format_exc())
          input(f"程序出错，错误信息已保存到error_log.txt，按回车退出...")
  

  重新打包后运行exe，即使闪退也会生成error_log.txt，里面有详细错误堆栈。

第二步：针对常见问题的解决方案 #

根据错误信息，大概率是以下几种情况：

• 依赖文件缺失：如果提示找不到某个库的配置文件、数据集（比如氨基酸序列数据库），用PyInstaller的--add-data参数手动添加。例如脚本用到data/amino_acids.csv，打包命令改为：

  pyinstaller --onefile --add-data "data/amino_acids.csv;data" 你的脚本名.py
  

  注意Windows下用;分隔源路径和目标路径，Mac/Linux用:。
• 路径错误：脚本中用相对路径读取文件时，打包后exe会把文件解压到临时目录，需用sys._MEIPASS获取该路径。原代码：

  with open("data/amino_acids.csv", "r") as f:
      # 读取文件逻辑
  

  修改为：

  import sys
  import os
  
  # 获取打包后的临时路径（未打包时取脚本所在目录）
  base_path = getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__)))
  file_path = os.path.join(base_path, "data/amino_acids.csv")
  with open(file_path, "r") as f:
      # 读取文件逻辑
  

• 库兼容性问题：部分生物信息学或科学计算库打包时需手动指定缺失模块，用--hidden-import参数补充，例如：

  pyinstaller --onefile --hidden-import "缺失的模块名" 你的脚本名.py
  

第三步：调试小技巧 #

• 先不用--onefile参数打包（默认生成文件夹），运行文件夹内的exe，若能正常工作，说明问题出在单文件打包的路径或依赖处理上；若仍闪退，说明脚本本身在当前环境存在问题。
• 确保打包用的Python环境与运行脚本的环境一致，避免因环境差异导致依赖缺失。

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