PyInstaller 使用大全

PyInstaller 是一个非常流行的 Python 打包工具，它可以将 Python 代码和其依赖的库打包成一个可执行文件，方便我们在其他不具备 Python 环境的机器上运行程序。本文将对 PyInstaller 的基本使用方法进行详细介绍，包括安装 PyInstaller、使用 PyInstaller 打包程序、解决打包时常见的问题等。

安装 PyInstaller

在安装 PyInstaller 之前，我们需要先安装 Python 环境。在安装完成后，我们可以使用 pip 命令来安装 PyInstaller，具体命令如下：

pip install PyInstaller

PyInstaller 使用示例

接下来我们将通过两个示例来演示 PyInstaller 的打包过程。

示例一：打包一个简单的 Python 脚本

1.创建一个名为 hello.py 的 Python 脚本，代码如下：

print("Hello, world!")

2.使用 PyInstaller 命令对该脚本进行打包：

pyinstaller hello.py

执行该命令后，PyInstaller 会将 hello.py 打包成一个可执行文件，并将其放置在当前目录的 dist/ 目录下。

3.运行打包后的可执行文件：

./dist/hello/hello

此时，程序将在终端输出 Hello, world!。

示例二：打包使用 Flask 框架编写的 Web 应用程序

1.使用 pip 命令安装 Flask：

pip install Flask

2.创建一个名为 app.py 的 Python 脚本，代码如下：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return '<h1>Hello, world!</h1>'

if __name__ == '__main__':
    app.run()

此时，我们的 Web 应用程序不仅使用了 Python 自带的库，还使用了 Flask 框架。

3.使用 PyInstaller 命令对该脚本进行打包：

pyinstaller --name=webapp --onefile app.py

执行该命令后，PyInstaller 会将 app.py 打包成一个可执行文件，命名为 webapp 并放置在当前目录的 dist 目录下。

4.运行打包后的可执行文件：

./dist/webapp

此时，在浏览器中访问 http://127.0.0.1:5000/，即可看到页面上输出 Hello, world!。

解决打包时常见的问题

在使用 PyInstaller 进行打包时，可能会遇到以下几个问题：

问题一：打包后程序无法运行

如果程序经过打包后无法正常运行，很可能是因为打包时没有包含必要的依赖文件。在这种情况下，可以通过在命令行中指定需要包含的依赖文件来解决问题，例如：

pyinstaller --name=webapp --onefile --add-data 'templates/*:templates/' app.py

上述命令表示将 templates 目录下的所有文件都打包进可执行文件中。

问题二：Windows 系统下打包的程序无法运行

在 Windows 系统下，PyInstaller 打包的程序可能因为缺少 VC++ 运行库导致无法正常运行。为了解决这个问题，我们需要在使用 PyInstaller 打包前先安装 Microsoft Visual C++ Redistributable。

问题三：打包的程序体积过大

由于 PyInstaller 将程序及其依赖库都打包进了一个可执行文件中，因此打包后程序的体积可能较大。为了解决这个问题，我们可以通过 --exclude-module 参数来排除一些不必要的模块，从而减小程序体积。例如：

pyinstaller --name=webapp --onefile --exclude-module=pandas app.py

上述命令中排除了 Pandas 模块，从而减小了程序体积。