Python脚本运行遇_tkinter缺失错误，交互环境却正常

问题描述 #

运行包含指定导入语句的Python脚本时，出现ModuleNotFoundError提示找不到_tkinter模块；但在Python交互解释器中执行相同的matplotlib.use('TkAgg')操作却无异常。

脚本代码 #

from __future__ import annotations

import math
from typing import Any, Optional, Union

import geometry as gm
import tk
import matplotlib
from matplotlib import pyplot as plt
import matplotlib.colors as mcolors
import numpy as np
from numpy.random import uniform as unif  # pylint: disable=g-importing-member


matplotlib.use('TkAgg')

报错信息 #

Traceback (most recent call last):
  File "/Users/janamzaveri/KRR/alphageometry/numericals.py", line 30, in <module>
    matplotlib.use('TkAgg')
  File "/Users/janamzaveri/KRR/alphageometry/krr_proj/lib/python3.10/site-packages/matplotlib/__init__.py", line 1255, in use
    plt.switch_backend(name)
  File "/Users/janamzaveri/KRR/alphageometry/krr_proj/lib/python3.10/site-packages/matplotlib/pyplot.py", line 415, in switch_backend
    module = backend_registry.load_backend_module(newbackend)
  File "/Users/janamzaveri/KRR/alphageometry/krr_proj/lib/python3.10/site-packages/matplotlib/backends/registry.py", line 323, in load_backend_module
    return importlib.import_module(module_name)
  File "/opt/homebrew/Cellar/python@3.10/3.10.14_1/Frameworks/Python.framework/Versions/3.10/lib/python3.10/importlib/__init__.py", line 126, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1050, in _gcd_import
  File "<frozen importlib._bootstrap>", line 1027, in _find_and_load
  File "<frozen importlib._bootstrap>", line 1006, in _find_and_load_unlocked
  File "<frozen importlib._bootstrap>", line 688, in _load_unlocked
  File "<frozen importlib._bootstrap_external>", line 883, in exec_module
  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
  File "/Users/janamzaveri/KRR/alphageometry/krr_proj/lib/python3.10/site-packages/matplotlib/backends/backend_tkagg.py", line 1, in <module>
    from . import _backend_tk
  File "/Users/janamzaveri/KRR/alphageometry/krr_proj/lib/python3.10/site-packages/matplotlib/backends/_backend_tk.py", line 9, in <module>
    import tkinter as tk
  File "/opt/homebrew/Cellar/python@3.10/3.10.14_1/Frameworks/Python.framework/Versions/3.10/lib/python3.10/tkinter/__init__.py", line 37, in <module>
    import _tkinter # If this fails your Python may not be configured for Tk
ModuleNotFoundError: No module named '_tkinter'

交互环境执行情况 #

Python 3.10.14 (main, Mar 19 2024, 21:46:16) [Clang 15.0.0 (clang-1500.3.9.4)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import matplotlib
>>> matplotlib.use('TkAgg')
>>>

原因分析与解决方法 #

核心原因 #

1. Python解释器不一致：脚本使用的是虚拟环境krr_proj内的Python，该环境的Python编译时未配置Tk依赖；而交互环境用的是系统全局的Homebrew Python，全局版本编译时包含了_tkinter支持。
2. 导入干扰：脚本中提前导入了import tk，会优先加载当前目录或虚拟环境中的tk模块，干扰后续matplotlib对标准库tkinter的正常导入。

解决步骤 #

• 统一解释器：用交互环境的Python路径执行脚本，比如运行/opt/homebrew/bin/python3.10 numericals.py。
• 给虚拟环境补全Tk支持：先安装Tk依赖brew install tcl-tk，再重新安装Homebrew Pythonbrew reinstall python@3.10，之后重新创建虚拟环境。
• 调整导入逻辑：删除脚本中的import tk语句，或者将matplotlib.use('TkAgg')移到所有导入语句最前面（matplotlib要求设置后端的代码必须在导入pyplot之前执行）。

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