使用PyInstaller打包Python程序时触发TypeError类型错误

可能的原因及对应解决方案 #

1. 修复tkcalendar的资源打包问题 #

tkcalendar依赖自带的locale资源文件，PyInstaller默认不会自动打包这些文件，导致程序运行时找不到资源返回None，触发类型错误。

• 打包时手动指定资源路径：
  Windows系统用分号分隔路径：

  pyinstaller --onefile --add-data "venv/Lib/site-packages/tkcalendar/locale;tkcalendar/locale" 你的脚本名.py
  

  macOS/Linux系统用冒号分隔路径：

  pyinstaller --onefile --add-data "venv/lib/python3.x/site-packages/tkcalendar/locale:tkcalendar/locale" 你的脚本名.py
  

2. 修正自定义模块的导入路径 #

如果脚本使用相对路径导入自定义模块，PyInstaller可能无法正确定位模块位置。

• 打包时用--paths参数指定自定义模块所在目录：

  pyinstaller --onefile --paths ./自定义模块所在目录 你的脚本名.py
  

• 把脚本中的相对导入改为绝对导入，避免路径解析错误。

3. 补充pandas的缺失依赖 #

PyInstaller有时会漏打包pandas的部分底层依赖组件，导致运行时出错。

• 用--hidden-import参数手动添加缺失的依赖，比如：

  pyinstaller --onefile --hidden-import pandas._libs.tslibs.timedeltas 你的脚本名.py
  

  若不确定缺失哪些依赖，可以先运行打包后的程序，根据报错信息逐一补充--hidden-import参数。

4. 排查代码中的None值引用 #

错误提示指向None类型的非法使用，可能是打包后程序读取文件路径时，因工作目录变化导致文件找不到返回None。

• 用sys._MEIPASS获取打包后的资源路径，统一处理文件读取：

  import sys
  import os
  
  def get_resource_path(relative_path):
      try:
          base_path = sys._MEIPASS
      except Exception:
          base_path = os.path.abspath(".")
      return os.path.join(base_path, relative_path)
  

  所有读取外部文件的逻辑，都用这个函数获取正确路径。

验证步骤 #

1. 先保留所有导入语句、注释掉业务代码，打包测试是否能正常运行。
2. 逐步恢复业务代码，每次打包测试，定位触发错误的代码块。
3. 根据定位结果，对应使用上述方案修复。

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