WSL虚拟环境下PyInstaller打包含Tkinter的Python3.8脚本失败

1. 修复ModuleNotFoundError: No module named 'tkinter'问题 #

（1）安装系统级tkinter依赖 #

Linux下的tkinter属于系统级依赖，无法通过pip安装。你之前执行的sudo pip install tk无效，需要安装对应Python版本的系统tk包：

sudo apt-get update
sudo apt-get install python3.8-tk

（2）让虚拟环境继承系统site-packages #

虚拟环境默认会隔离系统级包，导致无法访问系统安装的tkinter。重新创建虚拟环境时添加--system-site-packages参数，让它继承系统的tkinter模块：

# 删除旧虚拟环境（若存在）
rm -rf venv
# 创建带系统site-packages的虚拟环境
python3.8 -m venv venv --system-site-packages
# 激活虚拟环境
source venv/bin/activate
# 重新安装所需依赖
pip install pandas requests pyinstaller

（3）调整PyInstaller打包参数 #

打包时除了声明隐藏导入，还需收集tkinter的资源文件，使用--collect-all tkinter参数：

pyinstaller --onefile --collect-all tkinter search_ucdp.py

注意：不要用sudo执行命令，激活虚拟环境后直接使用环境内的PyInstaller即可，sudo会切换到全局Python环境，破坏虚拟环境的隔离性。

2. 解决可执行文件无.exe后缀的问题 #

WSL属于Linux环境，PyInstaller在此环境下生成的是Linux可执行文件，自然不带.exe后缀。如果需要Windows可执行文件，需切换到Windows原生环境操作：

• 退出WSL，打开Windows PowerShell/命令提示符
• 安装Windows版Python3.8，创建Windows虚拟环境
• 安装依赖后用Windows版PyInstaller打包，命令示例：

pyinstaller --onefile --collect-all tkinter search_ucdp.py

生成的文件会自动带有.exe后缀。

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