博客

Pyinstaller打包工具的使用以及避坑

  • Post category:Python

PyInstaller是一个常用的Python打包工具，能够将Python程序打包成可执行文件，方便程序的发布和运行。本文将从安装PyInstaller开始，详细介绍PyInstaller的使用，并针对一些常见的问题和注意事项进行讲解。

安装PyInstaller

在使用PyInstaller之前，需要先将其安装到本地环境中。可以通过命令行来安装PyInstaller，具体过程如下：

pip install pyinstaller

安装完成后，可以通过以下命令检查是否安装成功：

pyinstaller --version

使用PyInstaller打包程序

使用PyInstaller打包程序的步骤如下：

步骤一：创建Python程序

首先需要编写一个Python程序，并将其保存为.py文件。这个Python程序可以是任何你想要打包的Python程序，比如一个命令行程序或者一个图形界面程序。

步骤二：打包程序

在命令行中输入以下命令，使用PyInstaller对程序进行打包：

pyinstaller --onefile <filename.py>

其中，<filename.py>是你的Python程序的文件名，打包完成后会在当前目录下生成一个可执行文件。

如果你的Python程序有依赖库，也可以将依赖库一起打包：

pyinstaller --onefile --add-data '<path to dependency>;.' <filename.py>

其中，<path to dependency>是你的依赖库的路径，.表示将依赖库放在生成的可执行文件的当前目录下。

步骤三：测试程序

打包完成后，我们可以先测试一下程序是否能够正常运行，用以下命令行来运行打包后的程序：

./<filename>

其中，<filename>是你生成的可执行文件的文件名。如果程序能够正常运行，就说明打包成功了。

避坑

在使用PyInstaller打包程序的过程中，可能会遇到一些问题。下面介绍一些常见的问题和解决方法：

1. 打包程序时遇到ImportError

在打包程序时，有时候会遇到ImportError的问题，这是因为PyInstaller默认只会打包程序中用到的最基本的Python库，如果你的程序中涉及到其他的库，就需要手动添加。

解决方法：

pyinstaller --onefile --hidden-import=<module> <filename.py>

其中，<module>是你需要添加的库的名称。

2. 打包Windows程序时遇到问题

在打包Windows程序时，可能会遇到一些问题，比如exe文件运行后闪退。这是因为Windows默认会开启一些保护机制，导致一些程序不能正常运行。

解决方法：

pyinstaller --onefile --noconsole <filename.py>

其中，--noconsole可以让生成的exe程序在后台运行，避免出现一些问题。

示例一

以下代码用于统计目录下所有文件的大小，并将结果输出到指定文件中：

import os

def get_size(start_path = '.'):
    total_size = 0
    for dirpath, dirnames, filenames in os.walk(start_path):
        for f in filenames:
            fp = os.path.join(dirpath, f)
            total_size += os.path.getsize(fp)
    return total_size

with open('output.txt', 'w') as f:
    f.write(str(get_size()))

使用以下命令进行打包：

pyinstaller --onefile filesize.py

其中，filesize.py是上述代码保存的文件名。

执行以上命令后，将在当前目录下生成一个可执行文件filesize，在控制台中执行./filesize命令输出文件大小。

示例二

以下代码用于查询一个数字是否是Fibonacci数列中的成员：

def is_fibonacci_number(n):
    if n < 0:
        return False
    a, b = 0, 1
    while b < n:
        a, b = b, a+b
    return b == n

if __name__ == '__main__':
    n = int(input('Enter an integer: '))
    if is_fibonacci_number(n):
        print('{} is a Fibonacci number.'.format(n))
    else:
        print('{} is not a Fibonacci number.'.format(n))

使用以下命令进行打包：

pyinstaller --onefile fibonacci.py

其中，fibonacci.py是上述代码保存的文件名。

执行以上命令后，将在当前目录下生成一个可执行文件fibonacci，在控制台中执行./fibonacci命令查询数字是否是Fibonacci数列中的成员。

以上就是PyInstaller的基本使用方法和一些常见问题的解决方法，希望能帮助到你。

Tags: