使用pyinstaller打包Python程序

骑猪看日落 2024-02-22 08:58 53阅读 0赞

#### 文章目录 ####

*  背景
 *  操作步骤
 *   *  使用anaconda创建虚拟环境
     *  使用\`pyinstaller\`打包
     *   *  代码路径问题
 *  程序相对路径
 *  参考文献

## 背景 ##

当写好`python`文件后，会希望可以打包成可执行文件，这样对方不需要下载`python`，双击就可以执行，简单方便。

为了满足这种需求，`python`提供了`pyinstaller`包。该包可以将`python`代码和所依赖的环境打包为`二进制可执行`文件。

下面我们一起来看下如何使用`pyinstaller`打包~

## 操作步骤 ##

### 使用anaconda创建虚拟环境 ###

为什么要创建虚拟环境呢？

一般`python`中会`import`第三方依赖包执行程序，所以打包的时候也需要将依赖的第三方包一起打包，这样用户才可以简单地双击运行程序。

`pyinstaller`进行打包时会打包当前`python`环境下所有包，所以为了缩减打包后的安装包体积，我们新建虚拟环境，在该虚拟环境中只安装用到的依赖包，避免无用的安装包增大体积。

明白了原理后，我们来进行环境的创建。

# 创建3.8 版本的python环境
    conda create -n 你的虚拟环境名称 python=3.8

安装所需依赖包（必须安装`pyinstaller`包，其他自己需要的包自行安装即可）

pip install pyinstaller

激活虚拟环境

conda activate 刚刚创建的虚拟环境名称

### 使用`pyinstaller`打包 ###

`cd`到要打包的文件夹下，执行如下命令进行打包：

# -F 表示统一打包成一个可执行文件，必须； -c 表示创建执行窗口，显示日志等，可选； 
    # --clean 表示删除上次打包的缓存，可选；bot.py 是程序的入口文件
    pyinstaller -F -c --clean bot.py

打包好后，会在`dist`文件夹下出现一个可执行打包文件。  
![在这里插入图片描述][1e807423554d4a5a87c9d8f324ea651a.png]

#### 代码路径问题 ####

如果在程序中读取了某文件，假设代码中文件路径是`./config.txt`，表明程序会读取当前文件路径下`config.txt`文件，在双击运行时，一定要确认可执行文件的同级目录下存在`config.txt`文件。

否则程序会`闪退`，看不到报错，其实是因为找不到文件而异常退出了。

## 程序相对路径 ##

这里再补充一下路径问题：

程序中经常会使用相对路径，那么这个路径是相对谁来说呢？

运行时会有一个当前路径变量，如果使用命令行运行，那么这么当前路径变量就等于命令行所在路径。而双击时，当前路径变量就等于可执行文件所在的路径。

举例，现在有`文件夹a`，`文件夹b`在`文件夹a`中，可执行文件`demo.exe`在`文件夹b`中，`文件夹a`下还有配置文件`config.txt`。假设可执行文件在代码中读取了`./config.txt`文件。

如果终端当前路径在`文件夹b`下，执行命令`demo.exe`运行`文件夹b`下的可执行文件`demo.exe`，最终程序会报错找不到配置文件，这是因为当前路径变量是`文件夹b`，`文件夹b`并不存在配置文件`config.txt`。

## 参考文献 ##

[参考文献1][1]  
[参考文献2][2]

[1e807423554d4a5a87c9d8f324ea651a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/22/a3a4a3894bb94b3da50d52ef8f34307e.png
[1]: https://blog.csdn.net/weixin_52093215/article/details/124773733
[2]: https://blog.csdn.net/li11_/article/details/133635958