如何将多文件多类的Python tkinter项目打包为.exe文件？

关键前提检查 #

• 确保data和gui文件夹下都有__init__.py文件（空文件也可以），PyInstaller需要靠这个识别它们为Python包。
• 项目里所有文件引用都用相对路径：比如在main.py里导入模块用from data.year import YearClass，读取gui文件夹里的存储文件时用动态路径拼接，避免打包后路径失效。

步骤1：清理冗余文件 #

打包前先排除.idea、__pycache__这类无关内容，在项目根目录建一个exclude.lst文件，内容如下：

.idea/
__pycache__/
*.pyc

步骤2：用PyInstaller命令行打包（比auto-py-to-exe更可控） #

在项目根目录的终端里执行以下命令（Windows环境）：

pyinstaller --onefile --windowed --add-data "data;data" --add-data "gui;gui" --exclude-from-file exclude.lst main.py

参数说明：

• --onefile：打包成单个exe文件（不需要单文件就去掉这个参数）
• --windowed：隐藏控制台黑框（Tkinter应用必备）
• --add-data "源路径;目标路径"：把data和gui文件夹完整复制到打包后的目录，Windows用分号分隔，Mac/Linux换成冒号
• --exclude-from-file：跳过指定的冗余文件/文件夹

步骤3：修复数据存储文件的路径问题 #

如果gui文件夹里有.db、.json这类静态数据文件，代码里必须动态获取路径，示例代码：

import os

# 获取当前运行文件的绝对路径，打包后会指向exe所在目录
base_dir = os.path.dirname(os.path.abspath(__file__))
# 拼接gui文件夹下的存储文件路径
data_file_path = os.path.join(base_dir, 'gui', 'your_data_file.json')

常见错误排查 #

• 打包后提示模块找不到：检查__init__.py是否存在，导入语句是否正确，或者加--hidden-import 模块名强制导入缺失模块，比如--hidden-import data.year
• 运行exe时找不到数据文件：核对--add-data的路径是否正确，代码里的路径是否用了动态拼接
• PyCharm环境问题：确保用的是项目虚拟环境的PyInstaller，直接在PyCharm的Terminal里执行命令会自动激活虚拟环境

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