ttkbootstrap配合Pyinstaller打包单文件exe报错找不到themes.json求助

ttkbootstrap的themes.json属于第三方库内置的非.py格式资源文件，PyInstaller默认打包逻辑只会收集项目直接引用的.py字节码文件，不会自动抓取第三方库的静态资源，因此单文件exe运行时解压到临时目录后找不到对应配置文件就会触发报错。 #

方案1：打包命令直接追加资源参数（适合快速测试） #

打包时直接通过--add-data参数指定ttkbootstrap资源的映射关系：

• Windows系统命令示例：

pyinstaller -F --add-data "你的Python环境路径/Lib/site-packages/ttkbootstrap/themes.json;ttkbootstrap" main.py

• 非Windows（macOS/Linux）系统命令示例：

pyinstaller -F --add-data "你的Python环境路径/lib/pythonX.X/site-packages/ttkbootstrap/themes.json:ttkbootstrap" main.py

注：路径替换为你实际使用的Python环境（含虚拟环境）下ttkbootstrap包的对应路径。

方案2：修改spec配置文件（适合长期维护） #

1. 先生成配置文件：执行pyi-makespec -F main.py生成main.spec文件
2. 打开spec文件，找到datas配置项，修改为如下内容：

datas=[
    (r"你的Python环境路径/Lib/site-packages/ttkbootstrap/*.json", "ttkbootstrap"),
    (r"你的Python环境路径/Lib/site-packages/ttkbootstrap/assets", "ttkbootstrap/assets")
]

3. 用配置文件执行打包：pyinstaller main.spec

该方案可以一次性添加所有ttkbootstrap相关资源，避免后续出现字体、图标等其他资源找不到的问题。

方案3：代码侧适配打包环境（可选配合前两个方案使用） #

在导入ttkbootstrap之前增加环境判断逻辑，手动指定资源加载路径，避免路径映射错误：

import sys
import os
from pathlib import Path

# 检测是否为打包后的运行环境
if getattr(sys, "frozen", False):
    # 读取PyInstaller单文件解压的临时目录路径
    res_path = os.path.join(sys._MEIPASS, "ttkbootstrap")
    os.environ["TTKBOOTSTRAP_RESOURCES_PATH"] = res_path

# 再导入ttkbootstrap
import ttkbootstrap as ttk

• 如果你使用虚拟环境开发，必须匹配虚拟环境下site-packages中的ttkbootstrap路径，不要用全局Python的路径
• 打包后如果仍有其他资源报错，按照同样的逻辑把对应的资源目录添加到datas映射列表中即可

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