Ubuntu系统无法使用tkinter,安装及导入均报错如何解决
Ubuntu系统tkinter报错排查与解决
报错原因说明
你遇到的两个报错是Ubuntu平台Python tkinter的典型问题:
- pip安装时报错
ERROR: Could not find a version that satisfies the requirement tkinter,是因为tkinter不属于PyPI托管的第三方包,无法通过pip安装,Ubuntu将其作为独立的系统级软件包分发 - 导入时报错
ModuleNotFoundError: No module named 'tkinter',是因为当前使用的Python版本对应的tkinter系统包未实际安装,并非系统已预装。
解决步骤
- 第一步:确认当前使用的Python版本,终端执行命令:
python3 --version
记录返回的版本号,例如3.8、3.10等。 - 第二步:安装对应版本的tkinter系统包,终端执行如下命令:
通用Python3版本直接执行:sudo apt update && sudo apt install python3-tk
如果是特定Python版本(如Python3.8),执行对应版本包安装命令:sudo apt install python3.8-tk
按照提示输入密码确认安装即可。 - 第三步:验证安装结果,打开Python交互终端,执行导入命令:
import tkinter
无报错即为安装成功,也可执行tkinter._test()验证,会弹出tkinter的官方测试窗口。
注意事项
- 不要使用
pip install tkinter或pip install Tkinter命令安装,Ubuntu环境下无对应PyPI包,执行后必然报错 - 如果你使用虚拟环境,需要先在系统层面安装对应版本的python3-tk包,虚拟环境会自动继承该依赖,无需在虚拟环境内重复安装
- Python3的导入语句固定为小写
import tkinter,大写Tkinter是Python2的专属写法,Python3环境下不生效。
内容的提问来源于stack exchange,提问作者maxmiljan
相关产品推荐
相关产品推荐

