升级Python到3.13后PyCharm出现Tcl安装错误如何解决？

问题描述 #

升级Python到3.13后，在PyCharm运行程序时出现以下错误：

_tkinter.TclError: Can't find a usable init.tcl in the following directories: 
    C:/Users/kbens/AppData/Local/Programs/Python/Python313/lib/tcl8.6 {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/Earnie/.venv/lib/tcl8.6} {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/Earnie/lib/tcl8.6} {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/Earnie/.venv/library} {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/Earnie/library} {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/Earnie/tcl8.6.14/library} {C:/Users/kbens/OneDrive/Earnie TradeBot/Code/tcl8.6.14/library}

This probably means that Tcl wasn't installed properly.

手动安装最新版Tcl后问题仍未解决。

解决步骤 #

1. 修复Python 3.13的Tcl组件 #

• 打开路径 C:/Users/kbens/AppData/Local/Programs/Python/Python313/lib/，确认是否存在tcl8.6文件夹，且内部包含init.tcl文件。
• 若缺失，重新运行Python 3.13安装程序，选择修改选项，确保勾选“tcl/tk and IDLE”组件，完成修复安装。

2. 配置虚拟环境的环境变量 #

• 打开PyCharm，进入Settings > Project: 你的项目名 > Python Interpreter。
• 点击虚拟环境右侧的齿轮图标，选择Show All，选中当前.venv环境后点击Edit。
• 在弹出窗口中选择Environment Variables，添加两个变量：
  • 变量名：TCL_LIBRARY，值：C:/Users/kbens/AppData/Local/Programs/Python/Python313/lib/tcl8.6
  • 变量名：TK_LIBRARY，值：C:/Users/kbens/AppData/Local/Programs/Python/Python313/lib/tk8.6
• 保存设置后重启PyCharm，再运行程序。

3. 重建虚拟环境 #

• 删除项目目录下的.venv文件夹。
• 在PyCharm的Terminal中重新创建虚拟环境：

  python -m venv .venv
  

• 激活虚拟环境并重新安装所有依赖：

  .venv\Scripts\activate
  pip install -r requirements.txt
  

4. 调整系统环境变量 #

• 右键“此电脑”→属性→高级系统设置→环境变量。
• 检查系统变量中是否存在TCL_LIBRARY和TK_LIBRARY，若存在，确保其指向Python 3.13安装目录下的tcl8.6和tk8.6文件夹，而非单独安装的Tcl路径。
• 若不存在，手动添加这两个变量并设置对应路径。

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