PyInstaller打包Python详解转载记录下以备参考
PyInstaller打包Python详解
官⽹参考
⼀、PyInstaller简介
1.PyInstaller可以将Python项⽬在不同平台上打包为可执⾏⽂件.
2.PyInstaller打包的流程：读取编写好的Python项⽬–>分析其中条⽤的模块和库，并收集其⽂件副本（包括Python的解释器）–>将副本和Python项⽬⽂件（放在⼀个⽂件夹//封装在⼀个可执⾏⽂件）中.
⼆、pyinstaller的参数列表
参数 参数意义
-F
–onefile 1.打包单个⽂件，产⽣⼀个⽂件⽤于部署(默认)，如果代码都写在⼀个.py⽂件时使⽤，项⽬有多个⽂件时不要使⽤
例：pyinstaller -F xxx.py
例：pyinstaller --onefile xxxx.py
-D
–onedir 1.打包多个⽂件，产⽣⼀个⽬录⽤于部署(默认)，⽤于框架编写的代码打包
例：pyinstaller -D xxx.py（项⽬⼊⼝⽂件）
例：pyinstaller --onedir xxx.py（项⽬⼊⼝⽂件）
–key=keys 1.使⽤keys进⾏加密打包
例：pyinstaller --key=1234 -F xx.py
-K
–tk 1.在部署时包含 TCL/TK
-a
–ascii 1.不包含编码.在⽀持Unicode的python版本上默认包含所有的编码
-d
–debug 1.产⽣debug版本的可执⾏⽂件
-n name
–name=name 1.可选的项⽬(产⽣的spec的)名字name
2.第⼀个脚本的主⽂件名将作为spec的名字(默认)
例：pyinstaller -F -n my_file_name xxx.py
例：pyinstaller -F --name=my_file_name xxx.py
python怎么读取py文件-o dir
– out=dir 1.指定spec⽂件的⽣成⽬录dir
2.如果没有指定且当前⽬录是PyInstaller的根⽬录，会⾃动创建⼀个⽤于输出(spec和⽣成的可执⾏⽂件)的⽬录
3.如果没有指定切当前⽬录不是PyInstaller的根⽬录，则会输出到当前的⽬录下
-p dir
–path=dir 1.⽤来添加程序所⽤到的包的所在位置，设置导⼊路径(和使⽤pythonpath效果相似)
2.可以⽤路径分割符(Windows使⽤分号,Linux使⽤冒号)分割，指定多个⽬录.也可以使⽤多个-p参数来设置多个导⼊路径，让Pyintaller⾃⼰去程序需要的资源
-w
–windowed
–noconsole 1.表⽰去掉控制台窗⼝，使⽤Windows⼦系统执⾏，当程序启动的时候不会打开命令⾏(只对Windows有效)
例：pyinstaller -c xxx.py
例：pyinstaller xxx.py --noconsole
-c
–nowindowed
–console 1.表⽰打开控制台窗⼝，使⽤控制台⼦系统执⾏，当程序启动的时候会打开命令⾏(默认)(只对Windows有效)
例：pyinstaller -c xxx.py
例：pyinstaller xxx.py --console
-i
–icon=<file.ioc> 1.将file.ico添加为可执⾏⽂件的资源，改变程序的图标(只对Windows系统有效)
例：pyinstaller -F -i file.ico xxx.py
例：pyinstall -F --icon=<file.ioc> xxx.py
–icon=&,n> 1.将的第n个图标添加为可执⾏⽂件的资源(只对Windows系统有效)
-v file
–version=file 1.将verfile作为可执⾏⽂件的版本资源(只对Windows系统有效)
-s
–strip 1.可执⾏⽂件和共享库将run through strip.注意Cygwin的strip往往使普通的win32 Dll⽆法使⽤
-X
–upx 1.如果有UPX安装(执⾏Configure.py时检测)，会压缩执⾏⽂件(Windows系统中的DLL也会)(参见note)
三、Pyinstaller的使⽤
PyInstaller在Windows/Linux/Mac环境下的使⽤：执⾏命令相同，只需要在不同环境下执⾏即可
1.pyinstaller的安装
pip install pyinstaller
2.执⾏命令
2.1打包单个⽂件
1.执⾏命令
pyinstaller -F xxx.py
2.去⽣成的dist⽂件夹运⾏
3.运⾏成功，则为可执⾏⽂件，删除其它⽂件
2.2打包多个⽂件
1.执⾏命令，xxx.py为程序⼊⼝⽂件
pyinstall -D xxx.py
2.删除⽣成的bulid和dist⽂件夹，仅保留xxx.spec⽂件
3.修改xxx.spec⽂件，详见2.2.1
4.执⾏命令
pyinstaller -F xxx.spec
5.去dist⽂件夹下⽂件
6.运⾏成功，删除临时⽂件⽬录build；dist⽬录为打包的结果，可执⾏⽂件和其它程序运⾏的关联⽂件都在这个⽬录下
2.2.1 xxx.spec配置⽂件详解
-- mode: python --
block_cipher = None
以py⽂件为输⼊，分析py⽂件的依赖模块，并⽣成相应的信息
a = Analysis([‘xxx.py’], # 要打包.py⽂件名列表，和xxx.py同级可以不同添加
pathex=[‘D:\abc\def\project_v1.0’], # 项⽬路径
binaries=[], # 程序调⽤外部pyd、dll⽂件（⼆进制⽂件路径）以数组形式传⼊；例:(‘D:\pro\text.dll’, ‘pro’),
将’pdftotext.dll’pro，与原项⽬结构⼀致即可
datas=[], # 存放的资源⽂件（图⽚、⽂本等静态⽂件）以数组形成传⼊；例：(‘D:\static\c.ioc’,‘static’)，
将’cc.ioc’打包之后放在static⽬录，与原项⽬结构⼀致即可
hiddenimports=[], # pyinstaller解析模块时可能会遗漏某些模块（not visible to the analysis phase），造成打包后执⾏程序时出现类似No Module named xxx；这时就需要在hiddenimports中加⼊遗漏的模块
hookspath=[],
runtime_hooks=[],
excludes=[], # 去除不必要的模块import，写在excludes中添加此模块
win_no_prefer_redirects=False,
win_private_assemblies=False,
cipher=block_cipher)
.pyz的压缩包，包含程序运⾏需要的所有依赖
pyz = PYZ(a.pure, a.zipped_data,
cipher=block_cipher)
根据Analysis和PYZ⽣成单个exe程序所需要的属性及其配置
exe = EXE(pyz,
a.scripts,
exclude_binaries=True,
name=‘xxx’, # ⽣成exe⽂件的名字
debug=False, # debug模式
strip=False,
upx=True,
console=False, # 是否在打开exe⽂件时打开cmd命令框
icon=‘C:\Users\xx.ico’ ) # 设置exe程序图标，ico格式⽂件（16*16）
收集前三个部分的内容进⾏整合，⽣成程序所需要的依赖包，及资源⽂件和配置
coll = COLLECT(exe,
a.binaries,
a.zipfiles,
a.datas,
strip=False,
upx=True,
name=‘fastplot’)
四、踩坑
编辑.spec⽂件路径相关
1.windows尽量使⽤绝对路径，⽤双斜杠\ \
2.linux路径/home/my_project/web
3…路径避免使⽤中⽂
打包.spec⽂件报错：RecursionError: maximum recursion depth exceeded
1.在spec⽂件上添加递归深度的设置
import sys
sys.setrecursionlimit(5000)
2.图标的颜⾊严格限制：256，真彩⾊是不⾏的
打包错误：ModuleNotFoundError: No module named ‘xxxxx’⽅法1：pyinstaller -D --hidden-import=“xxxxx” main.py
⽅法2：在xxx.spec中配置hiddenimports=[‘xxxxx’]
运⾏exe⽂件报错：Failed to excute Script main
1.使⽤-c模式重新打包调试，的缺失的模块，pip install安装
⽂件打包后过⼤
1.在程序中尽量不使⽤import xx；⽽是使⽤ from xx import xx

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。