Python程序发布 Pyinstaller打包

阅读量：734 次

发布时间：2019-03-21

本文共 1977 字，大约阅读时间需要 6 分钟。

Pyinstaller安装与使用指南

安装Pyinstaller是将Python脚本打包为可执行文件的利器。以下是安装和使用方法，解决常见问题也包括在内。

1. 安装Pyinstaller

方法一：使用命令行安装

前往Python官方网站下载Pyinstaller。注意：Pyinstaller支持多种安装方式，以下使用常用方式。

打开终端，并添加Python环境的路径。如果不确定当前使用的Python版本，可以使用以下命令查找：

which python

执行以下命令安装Pyinstaller：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller

注意： Replace https://pypi.tuna.tsinghua.edu.cn/simple with your preferred镜像地址。

方法二：指定Python环境安装

确认当前工作目录已加载正确的Python环境。如果是在Pycharm项目中，可以指定项目根目录下的虚拟环境。

安装命令同上，但可以指定环境：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller

2. 打包Pyinstaller

方法一：命令行打包

在项目根目录下打开终端，执行如下命令：

pyinstaller -F -w "your_script.py"

-F：打包为单一文件。

-w：隐藏终端窗口，生成无界面程序。

对于图标，添加--icon选项：

pyinstaller -F -w "your_script.py" --icon "path/to/icon.ico"

方法二：自动化打包代码

放在项目根目录下创建pyinstaller_config.txt，修改配置：

echo '# -*- coding: utf-8 -*-' > pyinstaller_config.txtecho '__author__ = "your_name"' >> pyinstaller_config.txtecho ' Oy Ran: $(date +%Y%m%d)' >> pyinstaller_config.txtecho ' script_name = "your_script.py"' >> pyinstaller_config.txtecho ' icon_path = "path/to/icon.ico"' >> pyinstaller_config.txtecho ' upto압缩= True' >> pyinstaller_config.txt # 是否启用UPX压缩

添加过滤器，可以使用runpy_to_unpack，更灵活地管理打包文件：

# -*- coding: utf-8 -*-"""打包自动化脚本"""import runpy_to_unpack#编辑此处添加打包参数r = '你的程序路径'target_path = 'dist'#运行打包脚本runpy_to_unpack.run(r, target_path=target_path, associational_files=[r"your_icon.ico"])

3. 常见问题

错误提示：UnicodeDecodeError

错误信息：

UnicodeDecodeError: 'utf-8' codec can't decode byte...

解决方法：

尝试以管理员身份运行Pyinstaller。

确保图标文件的路径正确，或可尝试修改编码方式。

可能是PYĐGi／PYQt相关的打包问题，推荐重新安装相关库。

PYQt5打包失败

错误信息：

ModuleNotFoundError: No module named 'PyQt5'

解决方法：

确定PyQt5库路径确实存在，并确保Pyinstaller有权限访问。

我原来的项目使用了相对路径，改为绝对路径：

pyinstaller -F -w "your_script.py" -p "绝对路径"

4. Pyinstaller最佳实践

设置环境变量：确保PATH包含Python解释型的Python版本。

依赖管理：使用requirements.txt记录所需库，打包时可选择继承或重新安装。

图标优化：将图标转换为Base64格式嵌入程序，避免路径相关问题。

5. 开发环境推荐

Pychars： 提供内置Pyinstaller支持统一打包工具。

VSCode： 安装Pyinstaller扩展件，简化操作。

希望这些方法能帮助您顺利打包并分发Python程序！如有其他问题欢迎讨论。

转载地址：http://lrvgz.baihongyu.com/

你可能感兴趣的文章

mysql会员求积分_MySql-统计所有会员的最高前10次的积分和

查看>>

mysql会对联合索性排序优化_MySQL索引优化实战