Ubuntu下VSCode运行tkinter报ModuleNotFoundError但终端可正常执行

问题背景 #

Ubuntu系统，已通过sudo apt install python3-tk安装tkinter，终端运行代码正常，但VSCode中执行代码始终报ModuleNotFoundError: No module named 'tkinter'，调整解释器选项后仍无效。

解决方案 #

1. 确认终端使用的Python版本 #

在终端执行以下命令，获取当前能正常运行tkinter的Python解释器路径和版本：

which python3
python3 --version

记下输出的路径，比如/usr/bin/python3.10。

2. 在VSCode中指定正确的解释器 #

• 按Ctrl+Shift+P打开命令面板，输入Python: Select Interpreter
• 在弹出的列表中，找到和终端输出路径完全一致的解释器选项，选中它
• 如果列表里没有该路径，选择Enter interpreter path，手动输入你刚才记下的路径

3. 验证配置并重启终端 #

• 关闭VSCode中已打开的Python终端，重新打开一个新终端
• 运行你的tkinter代码，检查是否还报错

4. 额外排查项 #

• 如果VSCode左下角状态栏显示有虚拟环境标识（如venv、conda），说明当前使用的是虚拟环境，点击该标识切换到系统全局解释器
• 确保VSCode的Python插件是最新版本，可在扩展面板中检查更新
• 检查VSCode的settings.json配置：
  按Ctrl+Shift+P输入Preferences: Open Settings (JSON)，添加或修改以下配置（替换成你的Python路径）：

  "python.pythonPath": "/usr/bin/python3.10"
  

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