Mac系统使用PyInstaller打包PySimpleGUI应用提示缺少_tkinter模块如何解决

你遇到的ModuleNotFoundError: No module named '_tkinter'报错核心原因是pyenv默认安装的Python版本没有编译Tkinter绑定模块：MacOS自带的Tk框架版本过低，不符合Python 3.9的依赖要求，pyenv安装Python时会默认跳过Tkinter模块的编译，因此不管是直接重装tkinter库还是添加PyInstaller的hidden-import配置，都无法找到原生的_tkinter模块。

方案1：重新编译带Tkinter的Python版本（推荐，无需修改业务代码） #

• 先通过Homebrew安装符合要求的Tcl/Tk框架：
  brew install tcl-tk
• 配置编译环境变量，重新通过pyenv安装Python 3.9.6：
  如果是Intel芯片Mac，执行以下命令：

  PYTHON_CONFIGURE_OPTS="--with-tcltk-includes='-I/usr/local/opt/tcl-tk/include' --with-tcltk-libs='-L/usr/local/opt/tcl-tk/lib -ltcl8.6 -ltk8.6'" pyenv install 3.9.6
  

  如果是M系列Apple芯片Mac，执行以下命令：

  PYTHON_CONFIGURE_OPTS="--with-tcltk-includes='-I/opt/homebrew/opt/tcl-tk/include' --with-tcltk-libs='-L/opt/homebrew/opt/tcl-tk/lib -ltcl8.6 -ltk8.6'" pyenv install 3.9.6
  

• 切换到重新编译后的Python版本，新建虚拟环境，重新安装所有项目依赖（PySimpleGUI、PyInstaller等），避免旧缓存影响。
• 重新执行PyInstaller打包命令即可，无需额外添加hidden-import配置，_tkinter模块会被自动识别打包到可执行文件中。

方案2：替换GUI后端规避Tkinter依赖（无需重新编译Python） #

如果不想修改Python编译配置，可以将PySimpleGUI的Tk后端替换为Qt后端，仅需极小的代码改动：

• 安装Qt版本的PySimpleGUI：pip install PySimpleGUIQt
• 将代码中导入PySimpleGUI的语句从import PySimpleGUI as sg修改为import PySimpleGUIQt as sg，绝大多数上层API完全兼容，无需修改业务逻辑。
• 重新执行PyInstaller打包命令即可，不会再触发Tkinter相关的缺失报错。

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