macOS系统Python导入tkinter报错No module named '_tkinter'如何解决？

问题根因 #

tkinter是Python内置标准库，无法通过PyPI安装，你执行的pip3 install tk安装的是无关第三方包，不会解决依赖问题。报错本质是你当前的Python版本未绑定系统的Tcl/Tk框架。

修复步骤 #

• 若你使用Homebrew安装的Python：
  1. 先安装系统级Tcl/Tk依赖

     brew install tcl-tk
     

  2. 重装对应版本Python（你当前使用的是Python3.9，示例如下），重装时会自动绑定已安装的Tcl/Tk

     brew reinstall python@3.9
     

• 若你使用Python官网pkg包安装的Python：
  重新下载对应版本的Python安装包，安装过程中勾选「Tcl/Tk」可选组件即可。

验证方法 #

终端执行以下命令验证是否修复成功：

python3.9 -c "import tkinter; print('tkinter 导入成功')"

异常排查 #

如果重装后仍报错，执行which python3检查Python路径：

• Intel芯片Mac正常路径应为/usr/local/bin/python3
• Apple Silicon芯片Mac正常路径应为/opt/homebrew/bin/python3
  如果输出为/usr/bin/python3，说明你在用macOS系统自带的Python，该版本默认不支持tkinter，需要调整环境变量优先使用你自行安装的Python版本。

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