pyinstaller打包发布python程序

目录

1.打包项目（包含多个文件）

（1）全流程步骤

（2） start.spec配置文件详解

2.打包单个文件

3.注意

---

pyinstaller -h 命令可查看参数和用法

1.打包项目（包含多个文件）

（1）全流程步骤

""" 如果第一次运行pyinstaller命令，则需要执行1和2否则直接执行第3步及之后即可。"""
# 1.执行命令，start.py为程序入口文件
pyinstaller -D start.py 

# 2.修改start.spec文件,详见下面详解（2）

# 3.删除生成的bulid和dist文件夹

# 4.执行命令
pyinstaller -F start.spec

# 5.去dist文件夹下找start.exe文件

# 6.运行成功，删除临时文件目录build；dist目录为打包的结果，可执行文件和其它程序运行的关联文件都在这个目录下

（2） start.spec配置文件详解

# -*- mode: python -*-
  
block_cipher = None
  
# 以py文件为输入,分析py文件的依赖模块,并生成相应的信息
a = Analysis(['start.py', 'email2member.py', 'folder2zip.py', 'parseExcel.py', 'parsePdf.py', 'utils.py'], # 要打包.py文件名列表，和start.py同级的进行添加
       pathex=['C:\\Users\\jupy\\programs\\PyProgram\\pdf2excel'], # 项目路径
       binaries=[], # 程序调用外部pyd、dll文件（二进制文件路径）以数组形式传入;例:('D:\\pro\\text.dll', 'pro'),将'pdftotext.dll'pro，与原项目结构一致即可
       datas=[('resources\\发给慧姐的邮件正文.html','resources'),
                    ('resources\\发送给需要提交发票者的邮件正文.html','resources'),
                    (('resources\\团队人员信息维护表.xlsx','resources'))], # 存放的资源文件（图片、文本等静态文件）以数组形成传入;例：('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='start', # 生成exe文件的名字，后面运行就找这个名字。可以变更，非固定。
     debug=False, # debug模式
     bootloader_ignore_signals=False,
     strip=False,
     upx=True,
     console=True, # 是否在打开exe文件时打开cmd命令框
    # icon='C:\\Users\\xx.ico', # 设置exe程序图标，ico格式文件（16*16）
     disable_windowed_traceback=False,
     target_arch=None,
     codesign_identity=None,
     entitlements_file=None) 
     
# 收集前三个部分的内容进行整合，生成程序所需要的依赖包，及资源文件和配置
coll = COLLECT(exe,
        a.binaries,
        a.zipfiles,
        a.datas,
        strip=False,
        upx=True,
        upx_exclude=[],
        name='auto-bill-work-program') # dist文件夹里面的项目名字，例如pdf2excel\dist\auto-bill-work-program

2.打包单个文件（可用于简单测试）

# 1.执行命令
pyinstaller -F xxx.py

# 2.去生成的dist文件夹找xxx.exe运行

# 3.运行成功，xxx.exe则为可执行文件，删除其它文件

3.注意

（1）编辑.spec文件路径相关

1.windows尽量使用绝对路径，用双斜杠\ \

2.linux路径/home/my_project/web

3..路径避免使用中文

（2）打包.spec文件报错：RecursionError: maximum recursion depth exceeded

1.在spec文件上添加递归深度的设置

import sys

sys.setrecursionlimit(5000)

（3）更换exe图标报错：AttributeError: module 'win32ctypes.pywin32.win32api' has no attribute 'error'

1.图标的大小建议（64*64）: “岁寒” 非盈利使用

2.图标的颜色严格限制：256，真彩色是不行的

（4）打包错误：ModuleNotFoundError: No module named 'xxxxx'

方法1：pyinstaller -D --hidden-import="xxxxx" main.py

方法2：在xxx.spec中配置hiddenimports=['xxxxx']

（5）文件打包后过大

在程序中尽量不使用import xx；而是使用 from xx import xx

（6）运行exe文件报错：Failed to excute Script main

使用-c模式重新打包调试，找的缺失的模块，pip install安装