博客导语

Python代码不能直接双击运行，需要依赖解释器。PyInstaller是行业通用打包工具，可将 py 代码一键打包成 Windows EXE、Mac APP、Linux 可执行文件，无需Python环境即可运行，适合脚本交付、桌面工具、爬虫程序、小工具发布。

一、安装工具

pip install pyinstaller

二、基础打包命令

# 基础打包（生成exe+依赖文件夹） pyinstaller main.py # 单文件打包（所有依赖合并为一个exe） pyinstaller -F main.py # 静默打包（无黑窗口，GUI程序必备） pyinstaller -F -w main.py # 指定程序图标 pyinstaller -F -w -i icon.ico main.py

三、核心参数详解

• -F：onefile，打包为单个exe文件

• -w：windowed，关闭命令行黑窗口

• -i：指定程序图标

• --clean：打包前清理缓存

四、打包目录说明

• build：打包缓存文件（可删除）

• dist：最终exe输出目录（交付文件）

• .spec：打包配置文件

五、常见坑与解决方案

• 打包体积过大：在虚拟环境中打包，只保留项目依赖

• 双击闪退：代码末尾加input()或查看日志报错

• 资源文件丢失：手动拷贝静态资源到dist目录