使用cx_Freeze等工具打包含tkinter.tix的Python脚本为exe/msi时报错

核心原因 #

tkinter.tix依赖独立的tix运行时资源文件（包含动态链接库、主题配置文件等），IDLE运行时可以直接调用系统Python环境中自带的tix资源，而auto-py-to-exe、cx_Freeze等打包工具默认不会自动将tix资源封装到打包产物中，导致打包后的程序运行时找不到依赖触发报错。

解决方案 #

方案1：替换为原生Tooltip实现（优先选择，无额外依赖） #

tkinter 8.5及以上版本支持原生气泡提示，无需依赖tix库，打包兼容性更好，示例代码如下：

import tkinter as tk
from tkinter import ttk
# Python 3.10+ 自带Tooltip组件，低版本可自行实现简易气泡逻辑
try:
    from tkinter.tooltip import Tooltip
except ImportError:
    # 低版本Python简易Balloon实现
    class Tooltip:
        def __init__(self, widget, text):
            self.widget = widget
            self.text = text
            self.tip_window = None
            widget.bind("<Enter>", self.show_tip)
            widget.bind("<Leave>", self.hide_tip)
        
        def show_tip(self, event):
            x, y, _, _ = self.widget.bbox("insert")
            x += self.widget.winfo_rootx() + 25
            y += self.widget.winfo_rooty() + 25
            self.tip_window = tw = tk.Toplevel(self.widget)
            tw.wm_overrideredirect(True)
            tw.wm_geometry(f"+{x}+{y}")
            label = tk.Label(tw, text=self.text, background="#ffffe0", relief="solid", borderwidth=1)
            label.pack()
        
        def hide_tip(self, event):
            if self.tip_window:
                self.tip_window.destroy()
                self.tip_window = None

# 调用示例
root = tk.Tk()
test_btn = ttk.Button(root, text="测试按钮")
test_btn.pack(padx=50, pady=50)
Tooltip(test_btn, text="这是气泡提示内容")
root.mainloop()

方案2：手动打包tix资源（必须保留tix逻辑时使用） #

auto-py-to-exe打包配置

• 找到本地Python安装路径下的tix目录，通常为Python根目录/Lib/tkinter/tix
• 打开auto-py-to-exe配置页，在「高级-添加文件夹」中选择上述tix目录，设置打包后路径为tix
• 在脚本导入tix前添加路径声明代码：

import os
import sys

# 适配打包后运行环境的tix路径
if getattr(sys, 'frozen', False):
    os.environ['TIX_LIBRARY'] = os.path.join(sys._MEIPASS, 'tix')

from tkinter.tix import *

cx_Freeze打包配置

在setup.py的build_exe参数中添加tix目录的打包规则即可，示例配置：

import sys
from cx_Freeze import setup, Executable

build_exe_options = {
    "include_files": [
        # 替换为你本地tix目录的实际路径
        (r"C:\Python39\Lib\tkinter\tix", "tix")
    ]
}

setup(
    name = "测试程序",
    version = "1.0",
    description = "带气泡提示的程序",
    options = {"build_exe": build_exe_options},
    executables = [Executable("你的脚本文件名.py", base = "Win32GUI" if sys.platform == "win32" else None)]
)

内容的提问来源于stack exchange，提问作者Francisco Araya Carvajal