QPyPack

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

基于 PyInstaller 与 Nuitka 的跨平台 Python 应用可视化打包构建工具

PyPI version Python versions PyPI Downloads Platform Support
Release Date Last Commit License GitHub stars

QPyPack 是一款致力于简化 Python 应用打包流程的可视化工具。它深度整合了 PyInstaller 与 Nuitka 两大主流编译引擎，将繁琐的终端命令行参数转化为直观、极简的图形界面交互，帮助开发者高效、高成功率地生成跨平台原生可执行程序。

📷 界面预览 (Screenshots)

主界面预览 设置面板预览 依赖管理预览 高级优化预览 关于页面预览

🚀 核心特性 (Key Features)

QPyPack 旨在解决传统命令行打包配置繁琐、依赖遗漏、跨平台兼容性差以及编译失败率高的问题：

1. 现代化 UI 与直观交互体验

  • 📥 拖放式载入 (Drag & Drop)：只需将 .py 或 .pyw 源代码文件拖入窗口，系统全自动完成解析与工作区初始化。
  • 🎨 纯矢量图标栈 (Material Design SVG)：全界面采用 Google Material 矢量图标，全面清理 Emoji 表情，彻底杜绝跨平台系统下字体回退导致的排版乱码与跳动。
  • 🌐 智能多语言 (i18n)：原生支持简体中文、繁体中文、英文、德语、法语、日语、韩语等全球主流语言，自动识别系统首选语言并支持无缝切换。
  • 📊 双模式实时日志查看器：引入“精简模式 (Concise)”与“详细模式 (Detailed)”双视图日志面板，支持实时捕获编译引擎极细粒度的编译进度、一键导出与高亮提示。

2. 双编译后端与智能环境嗅探

  • ⚙️ PyInstaller & Nuitka 架构：图形化界面一键切换引擎，根据所选引擎自适应提供针对性的优化选项与参数控制。
  • 🔍 C/C++ 编译器智能嗅探：Nuitka 引擎下自动探测系统内已安装的 MSVC、Clang (LLVM) 及 Zig（专为 Python 3.13+ C 后端优化）编译器并优先调用，免除繁琐的环境变量设置。
  • 💻 Python 平台兼容性卡片：动态显示当前选中 Python 解释器对 Windows 7/8/10/11、macOS 及 Linux 的支持状态，并提供官方下载引导。

3. 三重安全依赖网与零配置预设

  • 🛡️ 隔离虚拟沙盒 (Virtualenv Sandbox)：一键在系统临时目录创建纯净构建沙盒，避免全局环境污染，极大精简产物体积。
  • 🔍 多维依赖自动补全：优先读取 requirements.txt；搭配深度原生 AST（静态语法树） 扫描引擎与 pipreqs，精准补齐隐式导入（Hidden Imports）。
  • 📦 免配置第三方库打包预设：内置对 ttkbootstrap、customtkinter、playwright、moviepy 等高频缺失/报错库的自动化打包处理，实现零配置一键生成。
  • ⚡ 多源 PIP 镜像与备用切源：内置主流镜像加速源，支持主源超时自动平滑切换至备用源。

4. 强健的构建容错与自愈降级

  • 📏 编译前物理资源评估：自动评估物理内存与磁盘可用空间，智能调整并发 CPU 核心数。
  • 🛡️ OOM 溢出自愈：构建过程中遭遇 ZstdError（内存溢出）时，自动触发单线程 (--jobs=1) 降级重试。
  • 🛡️ 图标锁定抗性：遭遇杀毒软件或系统锁定图标文件时，自动触发剥离图标参数自愈构建，保障二进制产物顺利生成。
  • ☁️ 云盘锁定预警：前置感知识别 OneDrive / Dropbox 等云盘对文件的锁定同步状态并提供明确排查提示。

5. 资源管理与应用元数据

  • 📝 PE / Plist 元数据注入：直接在界面设定版本号、公司名、产品描述，全自动写入 Windows PE VersionInfo 或 macOS Info.plist 结构。
  • 📂 可视化附加资源管理：提供列表化界面管理附加文件与文件夹，支持双击直接编辑打包后的相对释放路径（自适应路径映射）。

⚡ 快速上手 (Quick Start)

方法一：通过 pip 安装并运行

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

# 安装 QPyPack
pip install qpypack

# 启动程序
qpypack

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

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

📅 更新日志 (Changelog)

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

💖 赞助支持 (Sponsorship)

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

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

📄 开源协议 (License)

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

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

Copyright (C) 2026 QwejayHuang.

Project links

Data verified by PyPI on Aug 1, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.7.11)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for qwejayhuang from gravatar.com qwejayhuang

Credits

Author: QwejayHuang

GitHub Statistics

Data verified by PyPI on Aug 1, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

GNU General Public License v3 (GPLv3) (GPL-3.0-only)

Requires

Python >=3.8

Provides Extra

engines

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qpypack-2.7.0.tar.gz (668.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qpypack-2.7.0-py3-none-any.whl (696.2 kB view details)

Uploaded Python 3

File details

Details for the file qpypack-2.7.0.tar.gz.

File metadata

  • Download URL: qpypack-2.7.0.tar.gz
  • Upload date:
  • Size: 668.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qpypack-2.7.0.tar.gz
Algorithm Hash digest
SHA256 a29b3d553f780061824c93e92f32a27c9ec8af31dbb07de4cdc407c1535cae2f
MD5 99864670415018b1e984228f655986ae
BLAKE2b-256 702d561422e3885c725fc1d8673a776d6f92ea8d587baef9be301d1985ddb968

See more details on using hashes here.

Provenance

The following attestation bundles were made for qpypack-2.7.0.tar.gz:

Publisher: publish.yml on Qwejay/QPyPack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qpypack-2.7.0-py3-none-any.whl.

File metadata

  • Download URL: qpypack-2.7.0-py3-none-any.whl
  • Upload date:
  • Size: 696.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qpypack-2.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 46270522a98a04a77b67598c7cfa1fcf0bb580f844d52642f49bc4dd2685b61c
MD5 93bab42b5b69c0dabe5d9567590c30f2
BLAKE2b-256 3fbb04d0e97c5a5e63532fd3412ad539d3450eed6b5eca91dc77464f9200e0dc

See more details on using hashes here.

Provenance

The following attestation bundles were made for qpypack-2.7.0-py3-none-any.whl:

Publisher: publish.yml on Qwejay/QPyPack

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.7.11

2 files

2.7.10

2 files

2.7.9

2 files

2.7.8

2 files

2.7.7

2 files

2.7.6

2 files

2.7.5

2 files

2.7.4

2 files

2.7.3

2 files

2.7.2

2 files

2.7.1

2 files

This release

2.7.0 This release

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.7

2 files

2.5.6

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.6

2 files

2.4.5

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.9

2 files

2.3.8

2 files

2.3.6

2 files

2.3.5

2 files

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page