Python脚本经PyInstaller/Py2exe转换为exe后无法正常运行的问题排查及解决方案

这种情况我在日常打包脚本时碰到过好多次，核心原因大多和资源文件路径、依赖缺失或运行环境差异有关，结合你的文件夹结构，咱们一步步来排查解决：

1. 最常见：资源文件路径不匹配 #

直接运行Python脚本时，你是在脚本所在目录执行，相对路径（比如account_details.json）能正确指向文件；但打包成exe后，PyInstaller会把脚本解压到系统临时目录（比如C:\Users\XXX\AppData\Local\Temp\_MEIXXXXXX），这时原有的相对路径就找不到文件了。

解决方法： #

• PyInstaller打包时指定资源文件：
  用--add-data参数把资源文件打包进去，命令如下：

  pyinstaller --add-data "account_details.json;." --add-data "posts.xls;." actual_python_script.py
  

  （Windows用分号;分隔路径，Mac/Linux用冒号:）

• 代码中动态获取资源路径：
  修改脚本里加载文件的代码，通过sys._MEIPASS获取打包后的临时目录，示例：

  import os
  import sys
  
  def get_resource_path(filename):
      # 打包后用临时目录，未打包时用当前目录
      if hasattr(sys, '_MEIPASS'):
          return os.path.join(sys._MEIPASS, filename)
      return os.path.join(os.path.abspath("."), filename)
  
  # 加载json文件
  with open(get_resource_path("account_details.json"), "r", encoding="utf-8") as f:
      account_data = f.read()
  
  # 加载xls文件同理
  import pandas as pd
  df = pd.read_excel(get_resource_path("posts.xls"))
  

2. 依赖库未被正确打包 #

有些第三方库（比如一些小众的数据分析库、C扩展库）可能不会被PyInstaller自动检测到，导致exe运行时找不到依赖。

解决方法： #

• 用--hidden-import参数手动指定缺失的库，比如：

  pyinstaller --hidden-import "pandas._libs.tslibs.timedeltas" --add-data "account_details.json;." actual_python_script.py
  

• 建议用虚拟环境打包：创建干净的虚拟环境，只安装脚本需要的依赖，避免多余库干扰打包过程。

3. 隐藏了控制台报错信息 #

如果打包时用了-w参数（生成窗口程序，无控制台），即使exe运行出错，你在CMD里打开也看不到错误日志，误以为没有报错。

解决方法： #

• 先去掉-w参数，打包成控制台程序：

  pyinstaller --add-data "account_details.json;." actual_python_script.py
  

• 双击运行exe，控制台会显示具体的错误信息（比如“找不到某文件”“某模块缺失”），根据提示修复问题后，再按需添加-w参数。

4. 文件权限问题 #

如果把exe放在系统权限较高的目录（比如C:\Program Files），exe可能没有读写权限来加载或修改资源文件，导致运行异常。

解决方法： #

• 把exe和资源文件移动到用户有权限的目录（比如桌面、我的文档）；
• 右键exe，选择“以管理员身份运行”试试，看是否能正常执行。

5. Py2exe的特殊适配问题 #

Py2exe对Python3.8+版本的支持不如PyInstaller完善，容易出现兼容性问题。

解决方法： #

• 如果坚持用Py2exe，需要在setup.py中明确指定资源文件：

  from distutils.core import setup
  import py2exe
  
  setup(
      console=['actual_python_script.py'],  # 控制台程序，若要窗口程序用windows=['xxx.py']
      data_files=[('.', ['account_details.json', 'posts.xls'])]  # 将资源文件复制到dist目录根目录
  )
  

• 运行打包命令：

  python setup.py py2exe
  

  打包完成后，dist目录下会生成exe和复制好的资源文件，确保它们放在一起运行。

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