PyInstaller打包含sv_ttk的Tkinter程序为exe时缺失tcl文件报错

报错是PyInstaller默认打包规则没有收集sv_ttk依赖的Tcl主题资源，本地开发运行时可以直接读取Python环境site-packages目录下的sun-valley.tcl文件，打包后程序运行时的资源查找路径和本地环境不一致，且对应资源未被打入exe包，就会触发文件不存在的TclError。

• 清理旧打包缓存
  先删除项目目录下之前生成的build、dist文件夹和.spec打包配置文件，避免旧缓存干扰新的打包结果。
• 修改代码适配打包后的路径逻辑
  在代码导入依赖的部分添加资源路径适配函数，手动指定sv_ttk的主题文件查找路径，同时修正图标文件的读取逻辑，适配PyInstaller onefile模式的临时解压机制，修改后的导入段代码参考：

#imports >
import sys
import os
from tkinter import *
from tkinter import ttk
import sv_ttk as sv

# 适配PyInstaller打包后的资源路径
def get_resource_path(rel_path):
    if hasattr(sys, '_MEIPASS'):
        # onefile模式下资源会被解压到sys._MEIPASS对应的临时目录
        return os.path.join(sys._MEIPASS, rel_path)
    return os.path.join(os.path.abspath(os.path.dirname(__file__)), rel_path)

# 手动指定sv_ttk主题文件路径
sv.TCL_THEME_FILE = get_resource_path(os.path.join("sv_ttk", "sun-valley.tcl"))
#< imports

同时把原代码里设置图标的行替换为路径适配后的写法：

mainWindow.iconbitmap(default=get_resource_path('bubble.ico'))

• 执行打包命令时显式带入sv_ttk资源
  先找到本地Python环境中sv_ttk的安装目录，一般路径为Python安装根目录/Lib/site-packages/sv_ttk，打包时通过--add-data参数将整个sv_ttk目录打入包内，Windows环境下示例打包命令如下：

  pyinstaller --onefile --windowed --add-data "C:\Path\To\Your\Python\Lib\site-packages\sv_ttk;sv_ttk" bubble.py
  

  注意--add-data参数的写法，Windows下源路径和打包内目标路径用分号;分隔，Linux/macOS下用冒号:分隔。

• 如果使用onedir（非单文件）模式打包，不需要添加路径适配代码，只要在打包命令中带上--add-data参数把sv_ttk目录复制到dist生成的程序目录下即可正常运行。
• 打包前确认bubble.ico图标文件和你的py脚本放在同一目录下，避免图标资源找不到。
• 如果执行打包命令时提示找不到sv_ttk路径，直接在Python终端执行print(sv_ttk.__file__)就能拿到sv_ttk的准确安装路径，取该文件所在的sv_ttk文件夹即可。

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