Ubuntu 22.04下cx_Freeze打包Tkinter程序报找不到init.tcl错误

Ubuntu 22.04 软件源中 Python 3.10 绑定的 Tcl/Tk 版本为 8.6，你使用的 cx_Freeze 6.11.1 版本在 Linux 平台存在 Tcl/Tk 版本检测缺陷：初始化逻辑硬编码搜索 8.5 版本的 Tcl 资源路径，既不会自动复制系统中已安装的 8.6 版本 Tcl/Tk 资源到打包目录，也不会正确配置运行时的资源搜索路径，最终抛出找不到init.tcl的错误。

方案1：手动配置打包资源与运行时路径（无需升级依赖，兼容性最好） #

1. 先确认本机Tcl/Tk资源的实际路径，Ubuntu 22.04默认路径如下，也可以执行dpkg -L tcl8.6 tk8.6查看init.tcl所在的准确目录：
   • Tcl资源路径：/usr/share/tcltk/tcl8.6
   • Tk资源路径：/usr/share/tcltk/tk8.6
2. 修改setup.py，通过include_files配置把上述两个目录手动打包进输出目录：

from cx_Freeze import setup, Executable
import sys

# 替换为你本机实际查到的Tcl/Tk路径
TCL_PATH = "/usr/share/tcltk/tcl8.6"
TK_PATH = "/usr/share/tcltk/tk8.6"

build_options = {
    "packages": ["tkinter"],
    "excludes": [],
    "includes": ["tkinter"],
    # 将Tcl/Tk资源复制到打包目录下的tcl、tk子目录
    "include_files": [
        (TCL_PATH, "tcl"),
        (TK_PATH, "tk")
    ]
}

base = "Win32GUI" if sys.platform == "win32" else None
executables = [
    Executable("main.py", base=base, target_name="pydummy")
]

setup(
    name="pydummy",
    version="1.0",
    description="",
    options={"build_exe": build_options},
    executables=executables
)

3. 修改main.py入口代码，在初始化Tk窗口前，手动指定运行时的Tcl/Tk搜索路径：

#! /usr/bin/env python3
import os
import sys
import tkinter as tk

# 仅在打包后的exe环境下执行路径配置
if getattr(sys, "frozen", False):
    exe_dir = os.path.dirname(sys.executable)
    os.environ["TCL_LIBRARY"] = os.path.join(exe_dir, "tcl")
    os.environ["TK_LIBRARY"] = os.path.join(exe_dir, "tk")

root = tk.Tk()
root.mainloop()

修改完成后重新执行打包命令，生成的可执行文件即可正常启动Tkinter界面。

方案2：升级cx_Freeze到修复版本 #

cx_Freeze在后续版本中修复了Linux平台Tcl/Tk版本自动识别的问题，可以直接升级到最新稳定版后重新打包：

pip install --upgrade cx-Freeze

如果升级后仍偶发路径识别异常，搭配方案1中的运行时环境变量设置即可彻底解决问题。

前置依赖检查 #

如果操作后仍报错，先确认系统已经安装了Tkinter相关的系统依赖，执行以下命令安装：

sudo apt update && sudo apt install -y python3-tk tcl8.6 tk8.6

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