pyinstaller 如何打包python 代码

本文详细介绍如何使用PyInstaller工具进行Python项目打包,包括安装步骤、spec文件生成与配置,重点讲解了pathex和datas配置项,以及打包后的执行和注意事项。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

本次文章主要介绍,pyinstaller 打包 python 常见的问题,以及解决办法

1、安装

pip install pyinstaller

2、使用最全面的 spec 配置文件方法打包

介绍:
root
|_ test
| |_ main.py
|_custom_module
|_config

如上:
在 root 下有 test, custom_module config 3个目录
test 下有 main.py 是入口脚本
custom_module 下包含自定的脚本
config 是一些配置文件
现在打包需要以 main.py 作为入口, custom_module 作为自定义依赖模块路径,
config 作为额外的资源文件

2.1 生成 .spec 文件

cd test
pyinstaller main.py

# 将会生成  main.spec

2.2 main.spec

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['main.py'],
    pathex=[],
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='main',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)
coll = COLLECT(
    exe,
    a.binaries,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='main',
)

重点介绍几个配置:
pathex 指定额外的模块路径
datas 指定额外资源文件路径

所以修改如下

# -*- mode: python ; coding: utf-8 -*-


a = Analysis(
    ['main.py'],
    pathex=['../../root'],
    binaries=[],
    datas=[('config/*','config')],
    hiddenimports=[],
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
)
pyz = PYZ(a.pure)

exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='main',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    console=True,
    disable_windowed_traceback=False,
    argv_emulation=False,
    target_arch=None,
    codesign_identity=None,
    entitlements_file=None,
)
coll = COLLECT(
    exe,
    a.binaries,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='main',
)

2.3 运行 pyinstaller

pyinstaller  main.spec --distpath=install  # distpath 指定输出的路径

#输出结果将会在
install/main/ 这个目录中
拷贝到其他路径的时候,需要直接拷贝 install/main 这个目录
因为其中包含了一些库
### 使用 Pyinstaller 打包 Python 代码为可执行文件 #### 工具简介 PyInstaller 是一款强大的工具,用于将 Python 脚本打包成独立的可执行文件。它支持多种操作系统(Windows、macOS 和 Linux),并允许开发者创建单文件形式的应用程序[^2]。 #### 安装方法 为了安装 PyInstaller,可以通过以下命令完成安装操作。推荐使用国内镜像源加速下载过程: ```bash pip install pyinstaller -i https://pypi.douban.com/simple --trusted-host pypi.douban.com ``` 此命令利用豆瓣的 PyPI 镜像来提升安装速度[^3]。 #### 常见参数说明 以下是常用的 PyInstaller 参数及其功能解释: | 参数 | 描述 | |---------------------|------------------------------------------------------------------------------------------| | `--onefile` | 将所有依赖项压缩到一个单独的 `.exe` 文件中,便于分发[^1]。 | | `--noconsole` | 对于 GUI 应用程序,隐藏控制台窗口,使界面更加简洁。 | | `--icon=FILE.ICO` | 设置生成的可执行文件图标,增强用户体验[^1]。 | | `--add-data SRC;DST`| 捆绑额外的数据文件(如图片、配置文件等),路径格式取决于平台;Windows 下为 `SRC;DST`[^2]。 | #### 实际案例 假设有一个名为 `setup.py` 的脚本需要被打包成单一的可执行文件,并附带自定义图标和数据文件,则可以按照如下方式进行操作: ##### 单一文件模式 如果希望生成一个完整的单文件版本,可以运行以下命令: ```bash pyinstaller --onefile setup.py ``` ##### 自定义图标 若想指定应用程序的图标,可以在上述基础上增加 `-i` 或 `--icon` 参数: ```bash pyinstaller --onefile --icon=custom_icon.ico setup.py ``` ##### 数据文件绑定 当项目中有外部资源(例如配置文件或图像)时,可通过 `--add-data` 参数将其嵌入最终产物中。例如,添加位于当前目录下的 `config.json` 到目标位置 `/data/` 中: ```bash pyinstaller --onefile --add-data "config.json;./data/" setup.py ``` 注意:对于不同操作系统,`--add-data` 的路径分隔符有所不同,在 Windows 上应采用分号 (`;`) 连接源与目标路径。 #### 特殊情况处理 有时某些隐式的导入可能未被正确识别,这时可以借助 `--hidden-import` 显式声明这些模块。比如某个脚本依赖了 `requests` 库却未能正常工作时,尝试这样调用: ```bash pyinstaller --onefile --hidden-import=requests setup.py ``` --- ### 注意事项 - 如果遇到旧版缓存干扰新构建的情况,建议加上 `--clean` 清理选项重试。 - 在开发阶段频繁修改代码期间,考虑去掉 `--onefile` 来减少每次编译所需时间。 --- 相关问题
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值