Python导入Tkinter报No module named '_tkinter'错误求助

故障根因 #

你执行的软链接操作改动了本地二进制路径优先级，导致Homebrew安装的Python3.9无法正确加载绑定的Tcl/Tk框架依赖，而Tkinter作为Python内置模块，必须和对应版本的Tcl/Tk编译绑定才能正常运行，pip安装的第三方tkinter包为过时别名包，无法解决内置模块缺失问题。

分步解决步骤 #

1. 安装Tcl/Tk依赖 #

执行Homebrew命令安装对应依赖：
brew install tcl-tk
安装完成后将tcl-tk加入全局环境变量，以下为zsh终端配置，若使用bash请替换为~/.bash_profile：

echo 'export PATH="/opt/homebrew/opt/tcl-tk/bin:$PATH"' >> ~/.zshrc
echo 'export LDFLAGS="-L/opt/homebrew/opt/tcl-tk/lib"' >> ~/.zshrc
echo 'export CPPFLAGS="-I/opt/homebrew/opt/tcl-tk/include"' >> ~/.zshrc
source ~/.zshrc

2. 重新编译安装Python3.9 #

Homebrew默认预编译的Python不会主动绑定新装的tcl-tk，需要手动从源码编译安装：
brew reinstall python@3.9 --build-from-source

3. 验证修复结果 #

执行测试命令：
python3 -m tkinter
若弹出空白的Tkinter测试窗口即代表修复完成，此时导入tkinter不会再触发ModuleNotFoundError报错。

注意事项 #

• 不要随意修改/usr/local/bin下的软链接指向Homebrew二进制文件，容易触发全局路径优先级错乱，影响其他依赖系统版本二进制的组件运行
• 标准Python的Tkinter为内置模块，无需通过pip安装，pip源中的同名包为过时无效的第三方别名包

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