Python zipapp打包教程（超级详细）

经过复杂的开发、调试之后，终于得到一个 Python 程序，这个程序或许精巧，或许有些古拙，但它是我们心血的结晶，我们当然希望将这个程序发布出来。

Python 提供了一个 zipapp 模块，通过该模块可以将一个 Python 模块（可能包含很多个源程序）打包成一个 Python 应用，甚至发布成一个 Windows 的可执行程序。

生成可执行的Python档案包

zipapp 是一个可以直接运行的模块，该模块用于将单个 Python 文件或整个目录下的所有文件打包成可执行的档案包。

zipapp 模块的命令行语法如下：

python -m zipapp source [options]

在上面命令中，source 参数代表要打包的 Python 源程序或目录，该参数既可以是单个的 Python 文件，也可以是文件夹。如果 source 参数是文件夹，那么 zipapp 模块会打包该文件夹中的所有 Python 文件。

该命令的 options 支持如下选项：

• -o <output>，--output=<output>：应选项指定输出档案包的文件名。如果不指定该选项，所生成的档案包的文件名默认为 source 参数值，并加上 .pyz 后缀。
• -p <interpreter>，--python=<interpreter>：改选项用于指定 Python 解释器。
• -m <mainfn>，--main=<mainfn>：该选项用于指定 Python 程序的入口函数。该选项应该为 pkg.mod:fn 形式，其中 pkg.mod 是一个档案包中的包或模块，fn 是指定模块中的函数。如果不指定该选项，则默认从模块中的 __main__.py 文件开始执行。
• -c，--compress：从 Python 3.7 开始支持该选项。该选项用于指定是否对档案包进行压缩来减小文件的大小，默认是不压缩。
• --info：该选项用于在诊断时显示档案包中的解释器。
• -h，--help：该选项用于显示 zipapp 模块的帮助信息。

下面在某目录下建立一个 app 子目录，该子目录用于包含多个 Python 程序。首先在该目录下开发一个 say_hello.py 程序：

def say_hello(name):
    return name + "，您好！"

然后在该目录下开发一个 app.py 程序来使用 say_hello 模块：

from say_hello import *

def main():
    print('程序开始执行')
    print(say_hello('孙悟空'))

在命令行工具中进入该目录（app 目录的父目录），然后执行如下命令：

python -m zipapp app -o first.pyz -m "app:main"

上面命令指定将当前目录下的 app 子目录下的所有 Python 源文件打包成一个档案包，并通过 -o 选项指定所生成的档案包的文件名为 first.pyz；-m 选项指定使用 app.py 模块中的 main 函数作为程序入口。

运行上面命令，将会生成一个 first.pyz 文件。接下来可以使用 python 命令来运行 first.pyz 文件：

python first.pyz
程序开始执行
孙悟空，您好！

通过命令行工具在 app 目录的父目录下执行如下命令：

python -m zipapp app -m "app:main"

上面命令没有指定 -o 选项，这意味着该命令将会使用默认的输出文件名：source 参数值加 .pyz 后缀。运行上面命令，将会在当前目录下生成一个 app.pyz 文件。

zipapp创建独立应用

通过上面介绍的方式打包得到的档案包中只有当前项目的 Python 文件，如果 Python 应用还需要使用第三方模块和包（比如前面介绍的需要连接 MySQL 的应用），那么仅打包该应用的 Python 程序是不够的。

为了创建能独立启动的应用（自带依赖模块和包），需要执行两步操作：

1. 将应用依赖的模块和包下载到应用目录中。
2. 使用 zipapp 将应用和依赖模块一起打包成档案包。

下面在 app 所在目录下再创建一个 dbapp 子目录，该子目录将会作为本应用的目录。接下来在 dbapp 目录下新建一个 __main__.py 文件作为程序入口，这样程序在打包档案包时就不需要指定程序入口了。

下面是 __main__.py 文件的代码：

from exec_select import *

# 执行query_db()函数
query_db()

其中，exec_select.py 文件需要自己添加，包含代码如下：

# 导入访问MySQL的模块
import mysql.connector

def query_db():
    # ①、连接数据库
    conn = conn = mysql.connector.connect(user='root', password='32147',
        host='localhost', port='3306',
        database='python', use_unicode=True)
    # ②、获取游标
    c = conn.cursor()
    # ③、调用执行select语句查询数据
    c.execute('select * from user_tb where user_id > %s', (2,))
    # 通过游标的description属性获取列信息
    for col in (c.description):
        print(col[0], end='\t')
    print('\n--------------------------------')
    # 直接使用for循环来遍历游标中的结果集
    for row in c:
        print(row)
        print(row[1] + '-->' + row[2])
    # ④、关闭游标
    c.close()
    # ⑤、关闭连接
    conn.close()

最后按照如下步骤将 dbapp 子目录下的应用打包成独立应用：

1. 通过命令行工具在dbapp当前所在目录执行如下命令：

   python -m pip install -r requirements.txt --target dbapp

   上面命令实际上就是使用 pip 模块来安装模块，其中 python -m pip install 表示要安装模块。--target 选项指定将模块安装到指定目录下，此处指定将依赖模块安装到 dbapp 子目录下。-r 选项指定要安装哪些模块，此处使用 requirements.txt 文件列出要安装的模块和包。-r 选项支持两个值：
   • 直接指定要安装的模块或包。
   • 使用清单文件指定要安装的模块和包。

   当应用依赖的模块较多时，建议使用清单文件来列出所依赖的模块。

   如果直接运行上面命令，pip 模块会提示找不到 requirements.txt 文件，因此需要在当前目录下添加一个 requirements.txt 文件，并在该文件中增加如下一行。

   mysql-connector-python

   如果项目需要依赖多个模块，则可以在 requirements.txt 文件中定义多行，每行定义一个模块。
   
   重新运行上面命令，将可以看到 pip 开始下载 mysql-connector-python 模块，下载完成后将可以在 dbapp 子目录下看到大量有关 mysql-connector-python 模块的文件。
2. 如果 pip 在 dbapp 子目录下生成了 .dist-info 目录，则建议删除该目录。
3. 使用 zipapp 模块执行打包操作。由于本例的 dbapp 子目录下包含了 __main__.py 文件，该文件将会作为程序入口，因此打包时不需要指定 -m 选项。使用如下命令来打包：

   python -m zipapp dbapp

   与上一节所使用的命令相比，该命令没有使用 -m 边项来指定程序入口，该程序将会使用档案包中的 __main__.py 文件作为程序入口。运行上面命令，将会得到一个大约为 18MB 的档案包。因为该档案包自包含了 mysql-connector-python 模块，所以比较大。

在创建了独立应用之后，只要目标机器上安装了合适版本的 Python 解释器，即可运行该独立应用。我们可以先使用如下命令卸载在 Python 目录下安装的 mysql-connector-python 模块：

pip uninstall mysql-connector-python

此时在本机的 Python 目录下不再包含 mysql-connector-python 模块，但 dbapp.pyz 程序依然可以正常运行，因为它自包含了 mysql-connector-python 模块。