【pyinstaller】打包方法介绍，以及一些报错的解决方法

小鱼儿 2022-09-09 14:52 514阅读 0赞

### 文章目录 ###

*  一、打包方法
 *   *  1、pyinstaler参数介绍
     *  2、打包单个.py文件
     *  3、打包多个.py文件
 *  二、出现的问题
 *   *  1、pandas打包时报错：RecursionError: maximum recursion depth exceeded while calling a Python object
     *   *  （1）问题
         *  （2）原因
         *  （3）解决方法
     *  2、如果出现如pandas、matplotlib、numpy无法导入的问题
     *  3、pyinstaller报错UnicodeDecodeError: ‘utf-8‘ codec can‘t decode byte 0xce in position 118
 *  三、打包的文件太大？用虚拟环境！
 *   *  1、使用pipenv创建虚拟环境
     *  2、使用virtualenv创建虚拟环境
 *  Reference

# 一、打包方法 #

## 1、pyinstaler参数介绍 ##

pyinstaller 各个参数：
    -F, –onefile    打包一个单个文件，如果你的代码都写在一个.py文件的话，可以用这个，如果是多个.py文件就别用
    -w,–windowed,–noconsole    使用Windows子系统执行.当程序启动的时候不会打开命令行(只对Windows有效)
    -D, –onedir    打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，我个人比较推荐这样，代码易于维护
    -K, –tk    在部署时包含 TCL/TK
    -a, –ascii    不包含编码.在支持Unicode的python版本上默认包含所有的编码.
    -d, –debug    产生debug版本的可执行文件
    -c,–nowindowed,–console    
    –clean	在本次编译开始时，清空上一次编译生成的各种文件	默认：不清除

*  其中`-F, -w, –clean`比较常用

## 2、打包单个.py文件 ##

*  注意，相关的引用的图片、html等文件需放在同一文件夹下，`-i ./xxx.ico` 设置图标

pyinstaller -Fw -i ./xxx.ico  xxx.py

## 3、打包多个.py文件 ##

*  用记事本打开`xxx.spec`，将相关文件都放到下图所框的列表中
 *  然后运行`pyinstaller xxx.spec`打包  
    ![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAbWlyYWNsZW9f_size_20_color_FFFFFF_t_70_g_se_x_16]

# 二、出现的问题 #

## 1、pandas打包时报错：RecursionError: maximum recursion depth exceeded while calling a Python object ##

### （1）问题 ###

- 使用pandas打包的时候，报了上述错误。
    - 打包代码行：`pyinstaller -F .\excel_deal.py`

### （2）原因 ###

*  似乎是pandas库递归遍历玩的太嗨了，超过了python的栈高度限制

### （3）解决方法 ###

1.  `pyinstaller -F xxx.py`  
    这一步肯定会报上述错误导致失败，但是会产生一个xxx.spec文件
2.  在xxx.spec文件中增加两行(添加在原文件第二行):
    
        import sys
        sys.setrecursionlimit(10000)
3.  `pyinstaller -F xxx.spec`打包成功。

## 2、如果出现如pandas、matplotlib、numpy无法导入的问题 ##

*  使用记事本打开xxx.spec文件，在`hiddenimports=[]`的方括号中，添加需要额外导入的包。
 *  在进行excel输入和输出时，记得导入`'xlrd', 'xlwt'`这两个未包含的包。
 *  然后输入`pyinstaller -F xxx.spec`打包成功。  
    ![在这里插入图片描述][watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAbWlyYWNsZW9f_size_19_color_FFFFFF_t_70_g_se_x_16]

## 3、pyinstaller报错UnicodeDecodeError: ‘utf-8‘ codec can‘t decode byte 0xce in position 118 ##

*  在pyinstaller打包前，cmd键入 `chcp 65001`
 *  重新打包，错误消失

# 三、打包的文件太大？用虚拟环境！ #

## 1、使用pipenv创建虚拟环境 ##

详细请看我的博客：[【pipenv】 快速入门，超全面的pipenv教程！][pipenv_ _pipenv]

## 2、使用virtualenv创建虚拟环境 ##

*  pyinstaller喜欢把没用的库一起打包进来
 *  所以要创建python虚拟环境，再打包，以免把不需要的包打进来

1.  首先安装`virtualenv`包
    
        pip install virtualenv
2.  然后使用`virtualenv`创建一个干净的python虚拟环境
    
        virtualenv example_env  # 命名请随意
3.  创建完成以后我们就会在python的Script文件夹里发现一个 与刚刚命名相同的文件夹
4.  用`cmd cd`到虚拟环境的Script目录然后 输入activate回车

*  ps: Win10下 当第二次使用此环境报错时 应该用管理员模式打开powershell提权：

1.  错误信息：

.\activate : 无法加载文件 H:\envproject\venv\Scripts\activate.ps1，因为在此系统上禁止运行脚本。有关详细信息，
    请参阅 https:/http://go.microsoft.com/fwlink/?LinkID=135170 中的 about_Execution_Policies。所在位置 行:1 字符: 1

1.  解决办法：
    
     *  以管理员身份打开PowerShell
     *  执行命令`set-executionpolicy remotesigned`

*  然后就可以开始愉快地pip安装必要模块 然后pyinstaller啦

# Reference #

1.  [打包时遇到pandas库报错处理][pandas]
2.  [解决pyinstaller报错UnicodeDecodeError: ‘utf-8‘ codec can‘t decode byte 0xce in position 118][pyinstaller_UnicodeDecodeError_ _utf-8_ codec can_t decode byte 0xce in position 118]
3.  [pyinstaller打包的坑，最重要（多个文件的打包）][pyinstaller]
4.  [pyinstaller打包的exe太大？你需要嵌入式python玄学 前提篇][pyinstaller_exe_python_]

[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAbWlyYWNsZW9f_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/436c30cf6666413f8599f7f5830bb490.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAbWlyYWNsZW9f_size_19_color_FFFFFF_t_70_g_se_x_16]: /images/20220829/d47edab4f9164f589e46e4841d34dec6.png
[pipenv_ _pipenv]: https://blog.csdn.net/miracleoa/article/details/120337590
[pandas]: https://blog.csdn.net/qq_41705041/article/details/79659030
[pyinstaller_UnicodeDecodeError_ _utf-8_ codec can_t decode byte 0xce in position 118]: https://blog.csdn.net/qq_43474959/article/details/107842767
[pyinstaller]: https://blog.csdn.net/qq_42500577/article/details/88703089
[pyinstaller_exe_python_]: https://zhuanlan.zhihu.com/p/76974787