将 python 打包成 exe

有的时候博客内容会有变动，首发博客是最新的，其他博客地址可能会未同步, 认准 https://blog.zysicyj.top

可点击链接 https://blog-1253652709.cos.ap-guangzhou.myqcloud.com//picgo/202401180921373.png 解答疑问

使用 PyInstaller 将 Python 程序打包成 EXE 文件

目录

  1. 引言
  2. PyInstaller 简介
  3. 安装 PyInstaller
  4. 使用 PyInstaller 打包 Python 脚本
    • 基本打包方法
    • 高级打包方法
  5. 解决常见问题
    • 依赖问题
    • 打包后的文件太大
    • 打包后的程序无法运行
  6. 使用 Spec 文件自定义打包过程
  7. 多平台打包
  8. PyInstaller 的高级功能
  9. 总结

1. 引言

随着 Python 在各个领域的广泛应用，越来越多的开发者希望能够将 Python 程序打包成独立的可执行文件（EXE 文件），以便在没有 Python 环境的计算机上运行。PyInstaller 是一个流行的工具，可以帮助我们轻松地将 Python 脚本打包成 EXE 文件。在这篇博客中，我们将详细介绍 PyInstaller 的使用方法及其高级功能，帮助您顺利完成打包任务。

2. PyInstaller 简介

PyInstaller 是一个将 Python 应用程序打包成独立可执行文件的工具。它支持多种操作系统，包括 Windows、macOS 和 Linux。PyInstaller 可以分析 Python 脚本及其依赖项，并将它们打包成一个独立的可执行文件，便于分发和运行。

3. 安装 PyInstaller

在使用 PyInstaller 之前，我们需要先安装它。可以通过 pip 进行安装：

1
pip install pyinstaller

安装完成后，可以使用以下命令验证是否安装成功：

1
pyinstaller --version

4. 使用 PyInstaller 打包 Python 脚本

基本打包方法

打包一个简单的 Python 脚本只需一个命令：

1
pyinstaller your_script.py

这个命令会在当前目录下生成一个 dist 目录，里面包含了打包后的 EXE 文件。build 目录包含了打包过程中产生的临时文件，your_script.spec 文件是 PyInstaller 的配置文件。

高级打包方法

在实际应用中，我们可能需要更多的自定义选项。以下是一些常见的高级打包选项：

  1. 单文件打包：将所有文件打包成一个 EXE 文件：

    1
    pyinstaller --onefile your_script.py

  2. 指定图标：为 EXE 文件指定一个图标：

    1
    pyinstaller --onefile --icon=your_icon.ico your_script.py

  3. 隐藏控制台：打包成没有控制台窗口的 GUI 程序：

    1
    pyinstaller --onefile --windowed your_script.py

5. 解决常见问题

依赖问题

在打包过程中，可能会遇到一些依赖项无法正确打包的问题。可以使用以下方法解决：

  1. 手动添加依赖项：在打包命令中使用 --hidden-import 选项添加缺失的模块：

    1
    pyinstaller --hidden-import=missing_module your_script.py

  2. 检查导入路径：确保所有依赖项都能在打包过程中正确找到。可以在脚本中添加一些路径设置代码。

打包后的文件太大

打包后的 EXE 文件可能会很大，这是因为 PyInstaller 默认会将所有依赖项打包进去。可以使用以下方法减小文件大小：

  1. 精简依赖项：检查和删除不必要的依赖项。

  2. 使用 UPX 压缩：安装 UPX 并在打包时使用 --upx-dir 选项进行压缩：

    1
    pyinstaller --onefile --upx-dir=/path/to/upx your_script.py

打包后的程序无法运行

如果打包后的程序无法运行，可以尝试以下步骤：

  1. 检查错误日志：查看 dist 目录中的错误日志文件，找出错误原因。
  2. 测试脚本独立运行：在打包之前，确保脚本可以在 Python 环境中独立运行。
  3. 更新 PyInstaller：确保使用的是最新版本的 PyInstaller。

6. 使用 Spec 文件自定义打包过程

Spec 文件是 PyInstaller 的配置文件，可以用来自定义打包过程。创建 Spec 文件后，可以编辑它来添加更多的打包选项。以下是一个简单的 Spec 文件示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# -*- mode: python -*-

block_cipher = None

a = Analysis(
    ['your_script.py'],
    pathex=['/path/to/your_script'],
    binaries=[],
    datas=[],
    hiddenimports=[],
    hookspath=[],
    runtime_hooks=[],
    excludes=[],
    win_no_prefer_redirects=False,
    win_private_assemblies=False,
    cipher=block_cipher,
)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
exe = EXE(
    pyz,
    a.scripts,
    [],
    exclude_binaries=True,
    name='your_script',
    debug=False,
    bootloader_ignore_signals=False,
    strip=False,
    upx=True,
    upx_exclude=[],
    runtime_tmpdir=None,
    console=True,
)
coll = COLLECT(
    exe,
    a.binaries,
    a.zipfiles,
    a.datas,
    strip=False,
    upx=True,
    upx_exclude=[],
    name='your_script',
)

使用 Spec 文件进行打包：

1
pyinstaller your_script.spec

7. 多平台打包

PyInstaller 支持在不同操作系统上打包 Python 程序。但是，在 Windows 上打包出的 EXE 文件只能在 Windows 上运行，macOS 和 Linux 也是同样的情况。如果需要在不同平台上运行，可以使用跨平台的虚拟机或 Docker 容器。

8. PyInstaller 的高级功能

PyInstaller 还提供了许多高级功能，如：

  1. 数据文件打包：将额外的文件（如配置文件、数据库等）打包到 EXE 中。
  2. 支持更多打包格式：支持打包成 MSI、RPM 等安装包格式。
  3. 加密和保护：对 Python 代码进行加密和保护。

9. 总结

在本文中，我们详细介绍了如何使用 PyInstaller 将 Python 脚本打包成 EXE 文件，并探讨了常见问题的解决方法和高级功能。通过合理利用这些工具和技巧，您可以更好地分发和部署 Python 程序。希望这篇博客对您有所帮助！