QPyPack

简体中文 | English | 繁體中文 | 日本語 | 한국어 | Français | Deutsch | Español | Русский | Português

---

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

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

💡 QPyPack 是什么？

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

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

---

🌟 为什么选择 QPyPack？

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

---

📷 界面预览 (Screenshots)

---

🚀 核心特性 (Key Features)

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

---

⚡ 快速上手 (Quick Start)

💡 新手初次使用？ 建议阅读 3 分钟 📖 快速入门指南 (QUICKSTART.md) 了解完整的图文打包流程与常见场景配置推荐。

方法一：通过 pip 安装并运行 (推荐)

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

# 安装 QPyPack
pip install qpypack

# 启动程序
qpypack

方法二：下载独立二进制免安装版

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

---

📅 更新日志 (Changelog)

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

---

💖 赞助支持 (Sponsorship)

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

• ⚡ *请作者喝奶茶：赞助支持 QPyPack（支持微信 / 支付宝）

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

---

📄 开源协议 (License)

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

Note

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

Copyright (C) 2026 QwejayHuang.