PyInstaller编译的Tkinter程序启动异版本Tcl程序报错问题

问题原因 #

• 未编译状态下，main_app.py（基于Python 3.10.8）和dummy_app.py（基于Python 3.9）各自调用对应Python版本自带的Tcl库，系统路径中两个版本的Tcl库相互独立，不会产生干扰，因此可以正常运行。
• 用PyInstaller将main_app.py编译为单文件exe时，会把Python 3.10.8对应的Tcl 8.6.12打包进可执行文件。当exe启动dummy_app.py时，会先将打包好的Tcl 8.6.12加载到内存，而dummy_app.py依赖的Python 3.9自带Tcl 8.6.9，同一进程内加载两个版本的Tcl库会触发版本不匹配错误。
• 直接运行dummy_app.py时，仅会加载自身对应的Tcl 8.6.9，不存在冲突，因此运行正常。

解决方法 #

方法1：统一Python版本 #

将dummy_app.py迁移至Python 3.10.8环境下开发或运行，确保两个程序依赖相同版本的Tcl库。编译main_app.py后，启动同版本环境的dummy_app.py即可避免版本冲突。

方法2：修改PyInstaller打包配置，排除Tcl/Tk库 #

打包main_app.py时，禁止PyInstaller将Tcl/Tk库打包进exe，让程序直接调用系统中已有的Tcl库：

1. 生成PyInstaller spec配置文件：

   pyi-makespec main_app.py
   

2. 编辑生成的main_app.spec文件，在Analysis模块的excludes列表中添加tkinter、tcl、tk：

   a = Analysis(
       ['main_app.py'],
       pathex=[],
       binaries=[],
       datas=[],
       hiddenimports=[],
       hookspath=[],
       hooksconfig={},
       runtime_hooks=[],
       excludes=['tkinter', 'tcl', 'tk'],
       win_no_prefer_redirects=False,
       win_private_assemblies=False,
       cipher=block_cipher,
       noarchive=False,
   )
   

3. 基于spec文件重新打包：

   pyinstaller main_app.spec
   

   注意：此方法要求系统中安装的Tcl版本能兼容两个Python程序，或确保dummy_app.py依赖的Tcl版本为系统默认加载版本。

方法3：通过独立子进程启动dummy_app.py #

在main_app.py中使用subprocess模块，调用Python 3.9的解释器独立启动dummy_app.py，让子进程单独加载对应版本的Tcl库，与父进程（exe）的Tcl环境完全隔离：

import subprocess
# 替换为你的Python 3.9解释器实际路径
subprocess.run(["C:/Python39/python.exe", "dummy_app.py"], shell=False)

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