Python Tkinter(Customtkinter) Matplotlib打包程序找不到init.tcl求助

用auto-py-to-exe打包了基于Python Tkinter(Customtkinter)与Matplotlib的应用程序，本地运行正常，但在4台未安装Python、Tkinter或Matplotlib的电脑上启动后崩溃，抛出_tkinter.TclError错误，提示无法找到可用的init.tcl文件。即使目标电脑安装Python后，错误仍存在，尝试现有公开解决方案均无效。打包后的程序包内已包含tcl目录，但仍触发该错误。

错误回溯 #

Traceback (most recent call last):
File "main.py", line 339, in <module>
File "customtkinter\windows\ctk_tk.py", line 38, in __init__
tkinter.Tk.__init__(self, **pop_from_dict_by_set(kwargs, self._valid_tk_constructor_arguments))
File "tkinter\__init__.py", line 2263, in __init__
_tkinter.TclError: Can't find a usable init.tcl in the following directories:
{C:\Users\krist\OneDrive\??????? ????\test\main\tcl} {C:/Users/krist/OneDrive/??????? ????/test/main/tcl8.6} {C:/Users/krist/OneDrive/Pa6omen nnom/test/lib/tcl18.6} {C:/Users/krist/OneDrive/Pa6omen nnom/test/lib/tcl8.6} {C:/Users/krist/OneDrive/Pa6omex naom/lib/tcl8.6} {C:/Users/krist/OneDrive/Pa6omen nnom/test/library} {C:/Users/krist/OneDrive/Pa6omeH naom/library} {C:/Users/krist/OneDrive/Pa6omex naom/tcl8.6.9/library} C:/Users/krist/OneDrive/tcl8.6.9/library
This probably means that Tcl wasn't installed properly.
[8016] Failed to execute script 'main' due to unhandled exception!

解决方案 #

1. 手动指定TCL/TK路径 #

在代码开头添加环境变量配置，强制指定打包后tcl目录的路径，确保程序能正确找到依赖：

import os
import sys

# 针对打包后的环境，指定TCL/TK库路径
if hasattr(sys, '_MEIPASS'):
    tcl_root = os.path.join(sys._MEIPASS, 'tcl')
    os.environ['TCL_LIBRARY'] = os.path.join(tcl_root, 'tcl8.6')
    os.environ['TK_LIBRARY'] = os.path.join(tcl_root, 'tk8.6')

同时，打包时需在auto-py-to-exe的Additional Files中添加本地Python安装目录下的tcl文件夹（通常路径为Python安装目录\tcl），保持目录结构输出到tcl/。

2. 修正auto-py-to-exe打包配置 #

• 切换到Advanced选项卡，在Hidden-imports中添加：tkinter、customtkinter、matplotlib.backends.backend_tkagg
• 在Additional Files中分别添加本地Python的tcl\tcl8.6和tcl\tk8.6目录，设置输出路径为tcl/tcl8.6和tcl/tk8.6
• 优先选择One Directory模式打包，避免单文件模式下的路径解析异常

3. 规避含特殊字符的路径 #

错误日志中路径出现乱码（如??????? ????），说明目标机的程序路径包含非ASCII字符、空格或特殊符号，导致Tcl无法正确解析路径。将程序移动到纯英文无特殊符号的目录下运行，例如C:\test\app\，不要放在OneDrive或含中文的文件夹内。

4. 使用PyInstaller命令行打包 #

若auto-py-to-exe的GUI配置存在遗漏，直接用PyInstaller命令行打包（替换C:\PythonXX为你的本地Python安装路径）：

pyinstaller --onefile --windowed --add-data "C:\PythonXX\tcl\tcl8.6;tcl/tcl8.6" --add-data "C:\PythonXX\tcl\tk8.6;tcl/tk8.6" --hidden-import tkinter --hidden-import customtkinter --hidden-import matplotlib.backends.backend_tkagg main.py

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