1. 为什么需要打包Python脚本为exe文件作为一个经常用Python写小工具的程序员我深知把.py文件发给别人使用时有多麻烦。对方不仅要安装Python环境还得配置各种依赖库。有次我给同事发了个自动化报表脚本光是帮他装环境就花了半小时最后发现还缺了个xlrd库没装...这就是为什么我们需要把Python脚本打包成独立的exe可执行文件。打包后的exe就像普通软件一样双击就能运行完全不需要考虑Python环境问题。我做过一个文件整理工具打包后发给20多个同事使用没有一个人遇到环境问题这才是真正的开箱即用。PyInstaller是目前最流行的Python打包工具它能把你的脚本和所有依赖项打包成单个exe文件。实测下来用它打包的exe兼容性非常好从Windows 7到Windows 11都能稳定运行。而且生成的exe文件大小也很合理一个简单的脚本打包后通常在5-10MB左右。2. 环境准备与基础打包2.1 安装PyInstaller首先确保你已经安装了Python建议3.6以上版本。打开命令提示符WinR输入cmd输入以下命令安装PyInstallerpip install pyinstaller我建议使用清华镜像源来加速下载pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后可以验证下版本pyinstaller --version2.2 准备你的Python脚本打包前有几点需要注意脚本和所有相关文件最好放在纯英文路径下检查脚本的所有import语句确保依赖库都已安装如果有数据文件需要读取建议使用相对路径我有个血泪教训曾经在脚本里用了绝对路径D:\我的文档\data.txt打包后发给别人完全无法运行。后来改用os.path.dirname(file)获取当前路径问题才解决。2.3 执行基础打包假设你的脚本叫main.py在脚本所在目录打开cmd执行pyinstaller -F -w main.py这个命令中-F 表示生成单个exe文件不加会生成一堆文件-w 表示不显示命令行窗口适合GUI程序main.py 是你的脚本文件名打包完成后exe文件会出现在dist文件夹里。第一次打包可能会比较慢1-2分钟因为要收集所有依赖项。3. 高级打包选项详解3.1 常用参数解析PyInstaller提供了丰富的参数来自定义打包行为。下面这些是我最常用的pyinstaller -F -w -i icon.ico --add-data data.txt;. main.py-i指定exe的图标文件后面会详细讲--add-data添加额外数据文件格式为源路径;目标路径--hidden-import显式指定一些隐式导入的库--upx-dir使用UPX压缩exe体积能减小30%左右有次我打包一个用了Pillow库的脚本总提示找不到某些模块。后来发现需要加上--hidden-importPIL._tkinter_finder3.2 处理常见打包问题打包过程中最常遇到的几个坑找不到模块错误可以用--hidden-import手动指定打包后程序闪退去掉-w参数看看报错信息文件体积过大使用--upx-dir参数压缩资源文件找不到确保使用--add-data添加代码中用sys._MEIPASS获取路径我建议在打包前先创建一个干净的虚拟环境只安装必要的依赖。这样可以避免把开发环境中的各种测试库都打包进去。4. 自定义exe图标全攻略4.1 准备图标文件exe图标需要使用.ico格式建议准备256x256和32x32两种尺寸。制作方法很简单准备一张正方形图片PNG/JPG都行使用在线转换工具如icoconvert.com下载生成的.ico文件我常用的技巧是用绿色背景的字母图标这样在任务栏更醒目。注意避免使用透明背景在某些系统上可能显示异常。4.2 添加图标到exe准备好.ico文件后打包时加上-i参数pyinstaller -F -w -i myicon.ico main.py这里有个细节图标文件必须和脚本在同一目录或者使用绝对路径。我遇到过因为图标路径包含中文导致打包失败的情况。4.3 图标不显示的排查方法如果打包后发现图标没变可能是以下原因Windows图标缓存没更新 - 重启电脑试试图标文件损坏 - 重新生成一次图标尺寸不支持 - 确保包含32x32和256x256版本路径问题 - 尝试把图标文件放在C盘根目录再打包我习惯在打包后用Resource Hacker工具检查exe文件确认图标资源是否真的嵌入成功了。5. 实战案例打包一个GUI程序最近我用PyQt5写了个图片压缩工具完整打包命令如下pyinstaller -F -w -i compressor.ico --add-data assets/*;assets/ --upx-dirupx391 main.py这里有几个关键点使用了UPX压缩提前下载UPX并指定路径添加了整个assets文件夹作为资源文件代码中访问资源文件要用这种方式import sys import os def resource_path(relative_path): if hasattr(sys, _MEIPASS): return os.path.join(sys._MEIPASS, relative_path) return os.path.join(os.path.abspath(.), relative_path) # 使用示例 icon_path resource_path(assets/icon.png)打包后的exe只有8MB比直接用PyInstaller打包PyQt5默认的30MB小多了。发给同事使用后反馈非常好完全不需要任何额外配置。