官网

PyInstaller官方网站：
http://www.pyinstaller.org/

国内镜像库

PyInstaller Gitee：https://gitee.com/mirrors/pyinstaller

简介

在开发一些小工具给他人使用时，他人的系统中可能并没有安装python环境或没有安装相应的第三方库，要求对方安装不怎么现实，特别是对方不是技术人员的时候，此时将开发好的脚步通过pyinstaller打包成一个可执行文件是个不错的选择。

pyinstaller本身可以跨平台使用，但这里的跨平台指的是pyinstaller本身，通过pyinstaller打包出来的文件是无法跨平台的，在MacOS下使用pyinstaller打包python程序，打包后的内容只可在MacOS下运行，在windwos下打包的python程序，只可在Windows下运行。

安装Pyinstaller

• 安装pywin32
  下载安装文件：查找到跟自己适用的python版本及window系统版本匹配的pywin32，下载后安装

使用pip命令安装：pip install pywin32

• 安装Pyinstaller
  下载安装文件安装：官网

使用pip命令安装：pip install pyinstaller

使用Pyinstaller

打包方式

• 使用下载Pyinstaller打包方式
  将需要打包的文件放在解压得到的Pyinstaller文件夹中，打开cmd窗口，把路径切换到当前路径打开命令提示行，输入以下内容（最后的是文件名）：

python pyinstaller.py -F myfile.py

• 使用pip Pyinstaller打包方式
  打开cmd窗口，把路径切换到文件所在路径(文件随便放在哪里都行)打开命令提示行，输入以下内容（最后的是文件名）：

pyinstaller -F myfile.py

打包参数

pyinstaller最重要的两个参数就是-F与-D参数

• -F：表示在 dist 文件夹下只生成单个可执行文件（内部包含所有依赖），不加默认会在 dist 生成一大堆依赖文件 + 可执行文件。
• -D：与 -F 相反用法。
• -W：表示去掉控制台窗口，如果你的程序是有界面的，可以不写这个参数。但是测试情况下建议先加上这个参数，因为如果打包不成功，运行时报错信息会在控制台上输出，没有控制台就看不到报错信息。
• -c：表示去掉窗框，使用控制台。
• -p：表示指定程序的依赖库位置或者自己定义需要加载的类路径，项目中包含多个自建模块的时候需要加上 -p aaa.py -p bbb.py -p ccc.py

• -i：表示可执行文件的图标，后面跟图标的路径（例 -i "icon.icns"，Mac 下图标文件为 icns 格式， Win 为ico 格式）。
• -n：设置打包后的应用名称，例 -n "小程序"。

• --hidden-import：后面跟模块名如 queue，用于告诉打包程序某个模块我用不着你不用打包进去。

打包命令

综上所述，最常用的命令为：

# 常用打包参数
# -F -D 互斥参数
-F  打包成一个 exe 文件，小项目可以采用，打开比较慢，多个 .py 打包时不能使用
-D  默认参数，打包结果放入到创建的文件夹中，可以看到里面有很多的依赖文件

# -w -c 互斥参数
-w  使用项目的 GUI 界面，无 cmd 控制台
-c  默认参数，使用 cmd 控制台 如果打包文件执行报错，可尝试用 -c 显示控制台

-n  执行项目的名称，默认 .py 的文件名
-i  将 ico 图标打包到 exe 文件中，（例 `-i "icon.icns"`，`Mac` 下图标文件为 `icns` 格式， `Win` 为`ico` 格式）。

--hidden-import 打包时导包信息
# 打包 PyQt 项目强烈建议 带上以下参数
--hidden-import PyQt5.sip

# 打包命令示例
# 在项目的根目录下执行打包命令
pyinstaller -F SendMsgPerson2.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 二级拉动（超过3天）

# 打包结果输出在项目根目录下的 dist 文件夹中
# 不建议使用 -F 打包成一个 exe 文件 所谓：打包一时爽，打开 5 秒钟
# 非 -F 命令下， 静态资源、建好的 Sqlite 数据库可以直接放入 dist 中生成的文件夹中

打包步骤

• 第一步，在App根目录输出cmd，进入命令窗口

• 第二步，在App根目录放入favicon.ico图标作为exe可执行文件的Logo

• 第三步，输入下面的命令进行打包

pyinstaller -F SendMsgPerson2.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 二级拉动（超过3天）

• 第四步，生成spec文件和exe可执行文件

• 第五步，借助Windows系统的“任务计划程序”定时执行exe可执行文件

分级拉动命令如下：

• pyinstaller -F SendTestTaskPerson.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 分级拉动（测试单提醒）
• pyinstaller -F SendMsgPerson.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 分级拉动（全部）
• pyinstaller -F SendBugPerson.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 分级拉动（缺陷提醒）
• pyinstaller -F SendBugRobotCard.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 分级拉动（缺陷提醒机器人）
• pyinstaller -F SendStoryPerson.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 分级拉动（BUG转需求提醒）
• pyinstaller -F SendZentaoDataPerson.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 个性化提醒（禅道与钉钉昨日数据）
• pyinstaller -F SendDruidPersonDev.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 接口性能自动化巡检机器人（开发环境）
• pyinstaller -F SendDruidPersonTest.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 接口性能自动化巡检机器人（测试环境）
• pyinstaller -F SendDruidPersonProd.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 长春轨道交通运营-接口性能巡检机器人（生产环境）
• pyinstaller -F SendDruidPersonProd1.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 长春轨道交通运营-读取接口平均耗时（生产环境）
• pyinstaller -F -w GuiLoginPage.py -i favicon.ico -p D:\work\tools\Python\Python36\Lib\site-packages -n 接口性能巡检机器人配置助手