okooooooo/QPyPack

0 Fork 0

Files

T

2026-08-07 01:39:25 +08:00

QPyPack

🚀 “只需拖入 Python 代码，剩下的交给 QPyPack！”

_{Drag, drop, and build — QPyPack takes care of the rest!}

QPyPack 是一款现代化的跨平台 Python 打包工具。它深度整合 PyInstaller 与 Nuitka 双核心打包引擎，将极其繁琐复杂的终端命令行参数与环境配置，转化为极简、直观、高成功的图形界面体验。

无论你是打包简单的脚本工具，还是包含复杂依赖（如 PySide/PyQt, Playwright, CustomTkinter, MoviePy 等）的项目，QPyPack 都能助你轻松生成纯净、高效的跨平台原生可执行文件。

告别噩梦般的命令行：无需再记忆繁琐的 --hidden-import、--add-data 路径分隔符和参数格式。
零门槛 C/C++ 编译器集成：自动嗅探本地 MSVC、Clang 或 GCC 环境；缺失时免交互自动托管下载 MinGW-w64 工具链，无需手动配置环境变量。
告别运行时 ModuleNotFoundError：首创“三重依赖安全网”（Requirements + 原生 AST 语法树扫描 + pipreqs），精准补全隐式依赖。
告别打包崩溃与中间死锁：自动评估物理内存，自带内存溢出（OOM）自愈重试、杀软图标锁定剥离重构建及 Temp 防锁沙盒。

✨ 极简拖拽，即刻启程：拖入 .py 或 .pyw 源代码，全自动完成应用元数据解析、工作区初始化与图标匹配。
⚙️ 双打包引擎自由切换：
- PyInstaller：打包速度快，兼容性极佳，零 C 编译器依赖。
- Nuitka：将源码编译为原生 C/C++ 二进制，体积更小、运行更快、代码深度抗反编译。
🔍 C/C++ 编译器智能托管：优先调用本地 MSVC、Clang (LLVM) 或 GCC；未检测到本地编译器时，由 Nuitka 自动托管下载兼容的 MinGW-w64 编译器。
🛡️ 三重依赖防护网：融合 requirements.txt、原生 AST 静态语法树 扫描与 pipreqs，智能捕获所有隐式导入（Hidden Imports）。
📦 复杂第三方库零配置预设：内置对 ttkbootstrap、customtkinter、playwright、moviepy 等高频报错/遗漏资源库的自动 Hooks 拦截与资源收集。
🛡️ 防锁沙盒与自愈机制：构建前物理资源评估，捕获内存溢出（OOM/ZstdError）自动降低并发重试，支持 Temp 目录防锁隔离，解决 OneDrive/杀软锁文件导致的构建中断。
🎨 纯矢量 UI & 多语言支持：全界面基于 Google Material SVG 矢量图标，完美适配高分屏缩放；原生支持中、英、日、韩、德、法等全球多语言无缝切换。

在 Python >= 3.8 的环境中，执行以下命令进行安装与启动：

# 安装 QPyPack
pip install qpypack

# 启动程序
qpypack

如果您不想配置本地 Python 环境，可直接在 GitHub Release 页面下载对应系统的预编译打包版本： 👉 下载预编译版本 (GitHub Releases)

完整的版本更新历史与 Release 说明请参阅 CHANGELOG.md 或 GitHub Releases 页面。

QPyPack 是一款完全开源且免费的项目，由作者利用业余时间开发与维护。如果本项目帮助您提高了开发效率或解决了打包难题，欢迎通过以下方式对项目进行自愿赞助。您的支持将是本项目持续更新的重要动力：

赞助说明：赞助完全出于自愿，属于对开源项目的无偿鼓励，不包含任何商业服务绑定或特定功能开发承诺。非常感谢每一位支持开源创作的朋友！

本项目基于 GNU General Public License v3.0 开源，允许在遵循协议条款的前提下自由分发、修改和二次开发。

Note

关于打包产物的版权：使用 QPyPack 构建生成的二进制文件/应用程序，其版权和开源许可完全由使用者自行决定，QPyPack 的 GPL-3.0 协议不会约束或影响用户打包后的程序。