Pyinstaller打包完整python项目使用虚拟环境的python项目的打包

最新推荐文章于 2026-06-06 13:03:51 发布

原创

最新推荐文章于 2026-06-06 13:03:51 发布 · 4.8k 阅读

Pyinstaller基本使用方法

安装pyinstaller

pip install pyinstaller

cd xxxxxxxxxxx

简单打包命令
可以用命令直接打包单文件，遇到项目时文件很多也可以用命令打包，但命令太长了过于繁杂，可以参考链接，通常用修改spec文件的模式，详见：二 python项目的打包方法

Pyinstaller可以通过简单的命令进行python代码的打包工作，其基本的命令为：

pyinstaller -option xxx.py

假如项目启动入口为xxx.py，首先需要以管理员身份启动cmd，然后cd到xxx.py所在的文件夹

当我们使用命令行直接打包，即 pyinstaller -D xxx.py 时：

1.生成默认的xxx.spec文件

```python
2.直接根据默认的main.spec文件进行执行pyinstaller -D xxx.spec完成默认的打包

options常用参数（按需求选择）：

-D 与 -F 相反用法，生成一个文件目录包含可执行文件和相关动态链接库和资源文件等，对于打包结果较大的项目，选用-D生成目录相比-F的打包方式，执行速度更快，但包含更加多的文件
-F 表示在 dist 文件夹下只生成单个可执行文件（内部包含所有依赖），不加默认会在 dist 生成一大堆依赖文件+可执行文件。
-w 表示去掉控制台窗口，如果你的程序是有界面的，可以不写这个参数，
-c 表示去掉窗框，使用控制台，推荐使用，会打印各种信息和log到控制台，加上这个参数生成的spec中的console=True
-p 表示自己定义需要加载的类路径，项目中包含多个自建模块的时候需要加上 -p aaa.py -p bbb.py -p ccc.py
-i 表示可执行文件的图标，后面跟图标的路径，可以自定义exe文件的图标，我尝试了好多次没成功
　　打包完毕后在 dist 文件夹下双击项目启动文件就可以执行了

二 Python完整项目的打包方法

参考：https://blog.csdn.net/weixin_42052836/article/details/82315118

以一个多文件和目录的Python项目为例，项目文件包含：1.Python源代码文件；2.图标资源文件；3.其它资源文件

以图中项目为例，Python源代码文件在多个目录下：bin, lib\app, lib\models, lib\views；图标资源文件在lib\icon目录下；其它资源文件在data目录下，包括文本文件，视频文件等等
在这里插入图片描述

1.生成 spec文件

为了实现自定义配置的打包：

第一步：需要生成启动文件默认的spec文件:（选择一个即可）

 pyi-makespec -w xxx.py 
 pyi-makespec -c xxx.py  # 生成的spec文件中console=True,即需要打印到控制台

第二步：打开生成的spec文件，根据自己的项目结构和需求，修改其默认脚本，完成自定义打包需要的配置。

spec文件是一个python脚本，其默认的结构如下：

# -*- mode: python -*-
 
block_cipher = None
 
 
a = Analysis(['fastplot.py'],
             pathex=['D:\\install_test\\DAGUI-0.1\\bin'],
             binaries=[],
             datas=[],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a