Python导入FreeSimpleGUI遇_tkinter.TclError问题求助

问题 #

我正在学习Python课程，在PyCharm中配置并运行FreeSimpleGUI及相关文件时遇到阻碍。使用的代码如下：

import functions 

import FreeSimpleGUI

我已安装Python 3.13.0版本与FreeSimpleGUI 5.1.1版本，且多次重装过相同及其他版本的程序。作为Python新手，我期望模块能像视频中那样正常运行（显示“Process finished with exit code 0”），但出现了如下错误：

Traceback (most recent call last):
  File "C:\Users\Aliss\PycharmProjects\PythonProject2\gui.py", line 2, in <module>
    import FreeSimpleGUI
  File "C:\Users\Aliss\PycharmProjects\PythonProject\.venv\Lib\site-packages\FreeSimpleGUI\__init__.py", line 41, in <module>
    tclversion_detailed = tkinter.Tcl().eval('info patchlevel')
                          ~~~~~~~~~~~^^
  File "C:\Users\Aliss\AppData\Local\Programs\Python\Python313\Lib\tkinter\__init__.py", line 2572, in Tcl
    return Tk(screenName, baseName, className, useTk)
  File "C:\Users\Aliss\AppData\Local\Programs\Python\Python313\Lib\tkinter\__init__.py", line 2459, in __init__
    self.tk = _tkinter.create(screenName, baseName, className, interactive, wantobjects, useTk, sync, use)
              ~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
_tkinter.TclError: Can't find a usable init.tcl in the following directories: 
    C:/Users/Aliss/AppData/Local/Programs/Python/Python313/lib/tcl8.6 C:/Users/Aliss/PycharmProjects/PythonProject/.venv/lib/tcl8.6 C:/Users/Aliss/PycharmProjects/PythonProject/lib/tcl8.6 C:/Users/Aliss/PycharmProjects/PythonProject/.venv/library C:/Users/Aliss/PycharmProjects/PythonProject/library C:/Users/Aliss/PycharmProjects/PythonProject/tcl8.6.14/library C:/Users/Aliss/PycharmProjects/tcl8.6.14/library

This probably means that Tcl wasn't installed properly.

请问我下一步该如何解决？

解决方案 #

1. 检查Python安装是否包含Tcl/Tk #

• 打开Python安装目录（C:\Users\Aliss\AppData\Local\Programs\Python\Python313），查看是否存在tcl文件夹，里面应有tcl8.6和tk8.6子文件夹。
• 如果没有，卸载当前Python，重新运行安装程序时勾选“Install Tcl/Tk”选项（默认可能未勾选），确保完整安装。

2. 手动设置环境变量 #

若Python安装目录已有tcl文件夹但程序无法识别，手动添加环境变量：

• 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。
• 在系统变量中添加：
  • 变量名：TCL_LIBRARY，变量值：C:\Users\Aliss\AppData\Local\Programs\Python\Python313\tcl\tcl8.6
  • 变量名：TK_LIBRARY，变量值：C:\Users\Aliss\AppData\Local\Programs\Python\Python313\tcl\tk8.6
• 添加后重启PyCharm，再运行代码测试。

3. 验证虚拟环境的Python解释器 #

• 打开PyCharm，进入项目设置（File → Settings → Project: PythonProject → Python Interpreter）。
• 确认当前使用的解释器是你安装的Python 3.13.0，而非其他版本或损坏的虚拟环境。
• 如果虚拟环境有问题，删除当前.venv文件夹，重新创建虚拟环境并安装FreeSimpleGUI。

4. 降级Python版本（可选） #

Python 3.13是较新版本，可能存在兼容性问题。可以尝试安装Python 3.12.x版本，该版本对Tcl/Tk的支持更稳定，安装时同样确保勾选Tcl/Tk组件，再重新配置项目环境。

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