QPyPack

项目概述

QPyPack 是一款专为 Python 开发者打造的跨平台图形化打包工具。通过深度整合 PyInstaller（解释器与字节码打包）与 Nuitka（C/C++ 原生编译）双核心引擎，将繁琐的底层编译参数、隐式依赖分析、环境隔离与资源收集等流程抽象为直观的可视化界面。无论用于打包轻量命令行脚本，还是包含大型复杂依赖（如 PySide6 / PyQt、Playwright、CustomTkinter、FastAPI 等）的桌面或服务端应用，QPyPack 均可提供稳定、高成功率且可重现的构建体验。

主要功能

• 双构建引擎无缝切换：PyInstaller 构建速度快、零 C 编译器依赖；Nuitka 将 Python 源码转译为 C/C++ 二进制，执行速度快、抗反编译能力强、产物体积小
• LTO 链接优化与模块剪枝：精简模式下支持 --lto=yes 链接时间优化；针对 PySide/PyQt 自动识别并剔除未引用的重型子模块（如 WebEngine、3D、Quick 等）
• 灵活产物形态：支持单文件 (--onefile) 与目录模式 (--onedir)，支持自定义依赖内部存放目录 (--contents-directory)
• 原生 AST 递归扫描：内置纯 Python 实现的抽象语法树静态分析器，无需执行代码即可递归分析源码及项目目录中的依赖导入
• 智能包名映射系统：内置主流第三方库导入名与 PyPI 包名映射表（如 cv2 → opencv-python、PIL → pillow），支持用户自定义扩展
• 废弃兼容包动态隔离：自动识别并屏蔽与目标 Python 版本内置模块冲突的过时 Backport 库
• C/C++ 编译器自动托管：自动检测本地 MSVC、Clang (LLVM) 与 GCC 环境；缺失时 Nuitka 引擎自动下载并托管兼容的 MinGW-w64 工具链
• 环境生命周期管理：支持独立隔离虚拟环境与共享虚拟环境模式；支持历史失效虚拟环境的一键扫描与空间清理
• 自适应资源与错误自愈：构建前自动评估磁盘与物理内存，低内存状态下自适应下调并发数；自动拦截内存分配溢出并降级为单线程低内存模式重试
• 智能数字签名托管：支持在 Windows 产物输出后自动应用 Authenticode 数字签名（兼容 Signtool 与 PowerShell 引擎，集成 RFC 3161 时间戳服务）；支持 macOS 下的一键 codesign 代码签名
• 自签名证书套件：内置 Windows 自签名代码签名证书（.pfx）生成工具
• 项目配置预设导入/导出：支持将所有构建参数、资源清单与映射规则导出为独立的 .qpypack 项目工程预设文件
• 拖拽即用：直接拖入 Python 源码即可自动解析模块元数据、推导入口点并匹配同级资源图标
• 矢量渲染与全球化 i18n：全界面基于 Google Material SVG 矢量图标绘制，内置 17 种语言的即时国际化系统

适用人群

• Python 开发者，需要将脚本或应用打包为可执行文件
• 需要为商业交付软件提供代码保护（Nuitka 原生编译）的开发者
• 需要跨平台（Windows、macOS、Linux）打包解决方案的团队

快速上手

1. 通过 pip / pipx 安装（推荐）：在 Python >= 3.8 环境中执行 pip install qpypack，然后运行 qpypack 启动图形界面；也可使用 pipx run qpypack 或 uvx qpypack 隔离运行
2. 使用独立预编译免安装版：无需预先安装 Python，直接从 GitHub Releases 下载适用于您操作系统的可执行文件
3. 首次使用建议：查阅 3 分钟快速入门指南 (QUICKSTART.md) 了解详细教程与典型场景配置

核心优势

• 双引擎驱动：一套界面同时支持 PyInstaller 与 Nuitka，灵活选择构建策略
• 可视化配置：将底层编译参数、依赖分析、环境隔离抽象为直观界面，大幅降低打包门槛
• 高成功率与可重现性：内置依赖分析、环境管理和错误自愈机制，确保构建稳定可靠
• 跨平台支持：支持 Windows、macOS、Linux，提供 17 种语言界面
• 构建产物版权自主：使用 QPyPack 构建生成的最终应用程序与二进制产物，其知识产权与开源授权完全由使用者自行决定，GPL-3.0 许可不会对编译产物施加传染性约束

系统要求

• 操作系统：Windows、macOS、Linux
• 额外依赖：Python >= 3.8（pip 安装方式）；预编译版无需预装 Python