【实战揭秘】从源码到EXE：复杂Python项目的“完美”打包指南

hello/
├── common/
│   └── common.py        # 数据库操作相关函数
├── media/
│   └── img/
│       └── tubiao.ico   # 程序图标
├── main.py              # 主程序文件
├── config.ini           # 程序配置文件
├── 配置文件.txt          # 数据配置文件，用于自动读取显示内容
├── database.db          # SQLite数据库
└── README.md            # 项目说明文档

pip freeze > requirements.txt

pip install -r requirements.txt

pip install pyinstaller

pyinstaller --name hello_world --onefile main.py

a = Analysis(
    ['main.py'],                    # 主程序入口文件
    pathex=[os.path.abspath('.')],  # 搜索路径：当前目录的绝对路径
    datas=[                         # 需要打包的额外数据文件
        ('配置文件.txt', '.'),       # 源文件 → 打包后的目标路径
        ('config.ini', '.'),
        ('database.db', '.')
    ],
    hiddenimports=['common.common'], # 隐藏导入（PyInstaller无法自动检测的模块）
)
exe = EXE(
    name='hello_world',             # 生成的可执行文件名称
    console=False,                  # 是否为控制台程序（False不显示黑色终端）
    icon=[r'media\img\tubiao.ico']  # 程序图标文件路径
)

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


a = Analysis(
    ['main.py'],                    # 主程序入口文件
    pathex=[os.path.abspath('.')],  # 搜索路径：当前目录的绝对路径
    binaries=[],                    # 需要包含的二进制文件（DLL、共享库等）
    datas=[                         # 需要打包的额外数据文件
        ('配置文件.txt', '.'),       # 源文件 → 打包后的目标路径
        ('config.ini', '.'),
        ('database.db', '.')
    ],
    hiddenimports=['common.common'], # 隐藏导入（PyInstaller无法自动检测的模块）
    hookspath=[],                   # 自定义hook文件路径
    hooksconfig={},                 # hook配置字典
    runtime_hooks=[],               # 运行时hook脚本
    excludes=[],                    # 要排除的模块
    noarchive=False,                # 是否不创建归档文件
    optimize=0,                     # 优化级别：0=不优化，1=移除assert，2=移除docstrings
)

pyz = PYZ(a.pure)  # 创建包含所有纯Python模块的ZIP归档

exe = EXE(
    pyz,                            # 从PYZ归档获取数据
    a.scripts,                      # 主脚本和依赖脚本
    a.binaries,                     # 二进制文件
    a.datas,                        # 数据文件
    [],                             # 兼容性参数（已弃用）
    name='hello_world',             # 生成的可执行文件名称
    debug=False,                    # 是否包含调试信息
    bootloader_ignore_signals=False, # bootloader是否忽略信号
    strip=False,                    # 是否去除符号信息
    upx=True,                       # 是否使用UPX压缩可执行文件
    upx_exclude=[],                 # UPX压缩排除列表
    runtime_tmpdir=None,            # 运行时临时目录
    console=False,                  # 是否为控制台程序（False不显示黑色终端）
    disable_windowed_traceback=False, # 是否禁用窗口程序的错误回溯
    argv_emulation=False,           # 是否启用参数模拟（主要用于macOS）
    target_arch=None,               # 目标架构
    codesign_identity=None,         # 代码签名标识（macOS）
    entitlements_file=None,         # 权限文件（macOS）
    icon=[r'media\img\tubiao.ico']  # 程序图标文件路径
)

pyinstaller hello_world.spec

├── config.ini           # 程序配置文件
├── 配置文件.txt          # 数据配置文件，用于自动读取显示内容
├── database.db          # SQLite数据库