用PyInstaller打包分发Python程序

运行 Python 程序，需要部署 Python 执行环境并安装依赖包，操作繁琐。

借助 PyInstaller 等工具，可以将 Python 程序和 Python 环境一起打包成可执行程序，极大改善部署体验。本文以一个简单的实验程序，演示打包方法。

实验程序

我们编写一个程序，并用它演示如何打包 Python 程序。程序通过 ntplib 查询 NTP 服务器 并输出相关信息：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


import ntplib

from datetime import (
    datetime,
)

def format_ts(ts):
    return datetime.fromtimestamp(ts).strftime('%Y-%m-%d %H:%M:%S')

def check_time():
    client = ntplib.NTPClient()
    rsps = client.request('asia.pool.ntp.org', version=3)

    print('Server:', ntplib.ref_id_to_text(rsps.ref_id))
    print('Offset:', rsps.offset)
    print('Time:', format_ts(rsps.tx_time))

if __name__ == '__main__':
    check_time()

先使用 virtualenv 初始化一个 Python 隔离环境进行实验：

1

$ virtualenv env

验证 Python 隔离环境功能是否正常：

1
2


$ env/bin/python --version
Python 3.7.1

接着执行 pip 工具安装依赖包：

1

$ env/bin/pip install ntplib==0.3.3

可以通过 python 命令执行程序了：

1
2
3
4


$ env/bin/python checktime.py
Server: 119.160.254.155
Offset: 0.004868745803833008
Time: 2019-02-01 19:34:17

PyInstaller

PyInstaller 工具用于将 Python 应用及其依赖打包成一个 单文件程序 。支持系统包括：

Windows
GNU/Linux
Mac OS X
FreeBSD
Solaris
AIX

使用之前，需进行安装：

1

$ env/bin/pip install pyinstaller==3.4

执行 pyinstaller 命令， checktime.py 是待打包脚本， -F 表示打包成单文件程序：

1

$ env/bin/pyinstaller -F checktime.py

如无意外，在 dist 目录下可以找到打包后的程序。可以直接执行：

1
2
3
4


$ dist/checktime
Server: 42.204.179.159
Offset: -0.024485349655151367
Time: 2019-02-01 10:51:08

将程序拷贝到其他同类型系统上，也可以 直接执行 。这样一来，其他系统既不用安装 Python 环境，也不用安装依赖库，即可执行 Python 应用，非常便捷！

【小菜学Python】系列文章首发于公众号【小菜学编程】，敬请关注：