通过 pyinstaller 将 python 脚本打包成可执行程序

1. 引言

很多时候，我们需要在 windows 环境编写和执行 python 脚本，但是去搭建一整套 python 运行环境看上去就过于繁琐了，即便是拥有 python 运行环境，脚本的执行也并不方便。 如果能把 python 脚本封装在一个可执行的 exe 文件中，通过双击运行，就会方便很多了。 pyinstaller 就是用来完成这个工作的，本文就来介绍 pyinstaller 的使用，让你将自己的 python 脚本封装成可执行文件。

2. pyinstaller

pyinstaller 的官网是：

http://www.pyinstaller.org/

pyinstaller 是一个 python 命令行工具，支持将 python2.7 或 python3.4~3.7 版本的 python 脚本通过透明压缩构建成更小的可执行文件。 事实上，pyinstaller 不知可以生成 windows 环境下的可执行程序 exe，还可以生成 GNU/Linux，Mac OS X，FreeBSD，Solaris 和 AIX 环境下的可执行程序，而其编译命令非常简单。 本文抛砖引玉，仅介绍 windows 环境下的 exe 文件的生成，如果其他系统环境中执行，只需要在安装 pyinstaller 时先安装对应的 OS 支持工具，执行相同命令即可生成对应环境的可执行文件。

3. pyinstaller 安装

安装 pyinstaller 前需要安装对应系统的支持工具。 要生成 windows 环境下运行的 exe 可执行文件，需要安装 pywin32，可以访问下面的链接下载对应版本的 PyWin32.whl 文件并安装：

https://www.lfd.uci.edu/~gohlke/pythonlibs/

安装好 pywin32 后，执行下面命令即可完成 pyinstaller 的安装：

pip install pyinstaller

4. pyinstaller 的使用

4.1. 基本用法

最简单的用法即是执行下面的用法：

pyinstaller scriptname script name 就是你的 python 脚本，这样就可以生成一大堆文件，其中有一个 exe 文件，点击执行该 exe 文件即可。

4.2. 常用选项

pyinstaller 常用选项

5. 需要注意的问题

1. file 等特殊变量可能无法返回正确的值，需要在打包前进行特殊关注
2. 我们的脚本通常是 utf-8 编码，但 windows 的控制台常常是 gbk 编码，因此常常会遇到乱码的问题，需要格外注意
3. 不同版本的 pyinstaller 的选项并不完全相同， 因此最好是执行 pyinstaller -h 查看当前版本 pyinstaller 支持哪些选项