PyInstaller打包报错TypeError: expected str...求助

问题根源 #

你的Python 3.11.3版本中，PyInstaller的hook-_tkinter.py钩子无法正确检测到tcl/tk的安装路径，导致返回None值触发报错；而Python 3.11.6修复了相关路径检测的兼容性问题，所以同事能成功打包。

可行解决方案 #

1. 手动指定tcl/tk路径打包 #

直接让PyInstaller强制收集_tkinter的所有依赖，或者手动添加tcl/tk的文件路径：

• 方案A：用--collect-all参数自动收集

python -m PyInstaller -F --collect-all _tkinter click.py

• 方案B：手动指定tcl/tk的安装路径（替换成你自己的Python安装路径）

python -m PyInstaller -F --add-data "C:\Python311\tcl\tcl8.6;tcl8.6" --add-data "C:\Python311\tcl\tk8.6;tk8.6" click.py

2. 配置系统环境变量修复路径检测 #

给系统添加tcl/tk的环境变量，让PyInstaller能正确找到路径：

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 添加两个系统变量：
   • 变量名TCL_LIBRARY，值为你的Python安装目录下的tcl\tcl8.6（比如C:\Python311\tcl\tcl8.6）
   • 变量名TK_LIBRARY，值为你的Python安装目录下的tcl\tk8.6（比如C:\Python311\tcl\tk8.6）
3. 重启命令行窗口，重新执行打包命令。

3. 升级Python到3.11.6版本 #

既然同事用Python 3.11.6配合同版本PyInstaller能成功，直接升级你的Python到3.11.6版本，再重新打包即可解决路径检测的问题。

4. 处理Excel依赖文件 #

你的脚本依赖的两个Excel文件需要确保打包后能被exe访问到：

• 简单方案：打包完成后，把两个Excel文件放到生成的exe同一目录下
• 打包嵌入方案：把Excel文件打包进exe，脚本中动态获取路径：
  先修改脚本中的Excel读取逻辑：

  import sys
  import os
  
  def get_excel_path(file_name):
      try:
          # 打包后exe运行时的临时资源路径
          base_dir = sys._MEIPASS
      except AttributeError:
          # 未打包时的当前工作目录
          base_dir = os.path.dirname(os.path.abspath(__file__))
      return os.path.join(base_dir, file_name)
  
  # 读取Excel文件示例
  excel1 = get_excel_path("your_first_excel.xlsx")
  excel2 = get_excel_path("your_second_excel.xlsx")
  

  然后打包命令添加--add-data参数：

  python -m PyInstaller -F --add-data "your_first_excel.xlsx;." --add-data "your_second_excel.xlsx;." click.py
  

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