py2exe，一个神奇的 Python 库

在众多Python打包工具中，py2exe无疑是一款出色的选择。它能够将Python脚本转换成可在Windows平台上独立运行的可执行文件，极大地方便了程序的分发与部署。本文将深入探讨py2exe的特性和使用方法，让你在创建桌面应用程序时更加游刃有余。

安装

要使用 py2exe 将您的 Python 脚本转换为 Windows 上的可执行程序，首先需要确保安装了 py2exe 库。以下是安装步骤：

1. 通过pip安装：打开命令行界面（Windows的CMD或PowerShell），输入以下命令来通过pip安装 py2exe：

   pip install py2exe
   

   确保您的pip是最新版本，以避免安装过程中可能出现的兼容性问题。

2. 确认安装成功：安装完成后，您可以通过以下命令来确认 py2exe 是否正确安装：

   python -m py2exe --version
   

   如果返回版本号，那么表示 py2exe 已经安装成功。

现在，py2exe 已经准备好帮助您将 Python 脚本打包成可执行程序了。接下来，您可以通过 setup.py 文件来配置和运行打包过程。在实际使用之前，我们将在接下来的章节中详细探讨 py2exe 的基本功能和高级功能。

功能特性

• 跨平台：能够在Windows环境下将Python脚本转换为可执行文件。
• 易用性：简单的命令行参数和配置脚本，快速实现打包。
• 兼容性：生成的可执行文件能够在未安装Python的机器上运行。
• 扩展支持：支持包含第三方库和模块的Python程序打包。
• 自定义：允许用户自定义打包过程中的细节，如图标、版本信息等。

基本功能

创建可执行文件

py2exe 的最基本功能是将 Python 脚本转换成 Windows 上的可执行文件（.exe）。以下是转换 Python 脚本的基本步骤：

# setup.py
from distutils.core import setup
import py2exe

setup(console=['your_script.py'])

# 运行命令行
# python setup.py py2exe

在上述代码中，your_script.py 是你想要转换成可执行文件的 Python 脚本文件名。运行 setup.py 脚本后，py2exe 将生成可执行文件。

单文件打包

py2exe 支持单文件打包模式，即将 Python 脚本和所有依赖打包成一个可执行文件。

# setup.py
from distutils.core import setup
import py2exe

setup(windows=['your_script.py'])

# 运行命令行
# python setup.py py2exe

在这个例子中，windows 参数用于指定 GUI 程序的入口点。

打包数据文件

如果你的程序需要读取额外的数据文件，你可以使用 data_files 参数包含这些文件。

# setup.py
from distutils.core import setup
import py2exe

data_files = [("my_data", ["data_file1.txt", "data_file2.txt"])]

setup(console=['your_script.py'], data_files=data_files)

# 运行命令行
# python setup.py py2exe

my_data 是一个目录名称，这个目录会被创建在生成的可执行文件所在的目录中，并包含指定的数据文件。

使用自定义图标

你可以为生成的可执行文件指定一个自定义图标。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['your_script.py'],
    options={"py2exe": {"dll_excludes": ["MSVCP90.dll"], "bundle_files": 1}},
    data_files=[('', ['your_icon.ico'])]
)

# 运行命令行
# python setup.py py2exe

在这个例子中，your_icon.ico 是你想要使用的图标文件。bundle_files 参数设置为 1 来确保所有文件被捆绑到一个可执行文件中。

排除不必要的 DLL 文件

有时，你可能想要从打包的应用程序中排除某些不必要的 DLL 文件。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['your_script.py'],
    options={"py2exe": {"dll_excludes": ["MSVCP90.dll"]}}
)

# 运行命令行
# python setup.py py2exe

在这里，MSVCP90.dll 是一个示例，你可以在 dll_excludes 列表中添加或删除其他 DLL 文件。

以上是 py2exe 的基本功能介绍，每个功能都配有了相应的代码示例和注释，以便读者能够快速理解和应用。

高级功能

自定义打包脚本

py2exe 允许通过自定义打包脚本来控制打包过程，以适应更复杂的打包需求。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['hello.py'],
    options={"py2exe": {
        "bundle_files": 1,  # 打包所有文件
        "compressed": True,  # 压缩打包文件
    }},
)

使用包含资源的包

当你的程序需要使用外部资源（如图片、数据文件等）时，可以通过 data_files 参数将这些资源包含在打包后的程序中。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['hello.py'],
    data_files=[('image', ['image/icon.png'])],  # 包含图片资源
)

使用自定义图标

你可以为打包后的可执行文件指定一个自定义图标。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['hello.py'],
    options={"py2exe": {
        "dll_excludes": ["MSVCP90.dll"],
        "icon_resources": [(1, "app.ico")],  # 自定义图标
    }},
)

生成单一可执行文件

py2exe 支持生成单一可执行文件，便于分发。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['hello.py'],
    options={"py2exe": {
        "bundle_files": 2,  # 生成单一可执行文件
    }},
)

指定排除的 DLL 文件

为减小打包后的程序体积，你可以通过 dll_excludes 参数指定不需要打包的 DLL 文件。

# setup.py
from distutils.core import setup
import py2exe

setup(
    console=['hello.py'],
    options={"py2exe": {
        "dll_excludes": ["MSVCP90.dll"],  # 排除特定 DLL
    }},
)

通过以上高级功能，你可以更灵活地控制 py2exe 打包过程，以适应不同场景下的打包需求。

实际应用场景

将Python脚本转换为可执行文件

使用py2exe可以将Python脚本打包成Windows平台下的可执行文件，方便分发和部署。

# setup.py
from distutils.core import setup
import py2exe

setup(console=['your_script.py'])

运行python setup.py py2exe命令后，会在dist目录下生成可执行文件。

创建图形用户界面（GUI）程序

py2exe也支持将使用PyQt或Tkinter等图形库的Python程序转换为可执行文件。

# setup.py
from PyQt4 import uic
from distutils.core import setup
import py2exe

class MyGUI:
    def __init__(self):
        # 加载UI文件
        self.ui = uic.loadUi("my_gui.ui")

setup(windows=['my_gui.py'])

运行python setup.py py2exe命令后，会在dist目录下生成GUI程序的可执行文件。

打包包含第三方库的脚本

当Python脚本依赖第三方库时，py2exe可以自动将依赖的库一起打包。

# setup.py
from distutils.core import setup
import py2exe
import numpy

setup(console=['your_script_with_numpy.py'])

确保第三方库已正确安装，并使用python setup.py py2exe命令打包。

制作安装包

通过py2exe，还可以创建包含可执行文件、依赖库和资源文件的安装包。

# setup.py
from distutils.core import setup
import py2exe

setup(
    windows=['your_app.py'],
    data_files=['path/to/your/resource/file'],
    options={'py2exe': {'bundle_files': 1}}
)

使用python setup.py py2exe命令生成安装包，并通过data_files参数包含额外的资源文件。

跨平台部署

尽管py2exe主要用于Windows平台，但它可以协助开发者在其他平台上开发的Python程序，在Windows平台上快速部署。

# setup.py
from distutils.core import setup
import py2exe

setup(console=['cross_platform_script.py'])

在Linux或macOS上开发完成后，只需在Windows平台上运行python setup.py py2exe命令即可生成可执行文件。

通过以上实际应用场景，可以看出py2exe为Python程序的分发和部署提供了极大的便利，尤其适用于需要在Windows平台上运行的场景。

总结

py2exe作为Python程序转exe的工具，简化了打包过程，提升了开发效率。它不仅支持基本转换需求，还提供了高级定制选项，满足了不同场景下的打包需求。通过本文的介绍，相信读者已对py2exe有了更深入的了解，能够在实际开发中更好地运用这一工具。

编程、AI、副业交流：https://t.zsxq.com/19zcqaJ2b
领【150 道精选 Java 高频面试题】请 go 公众号：码路向前 。