Repository navigation
V1.0.0
🎉 概述
NuitkaGUI 是 Nuitka 的图形化封装工具,基于 PySide6 开发。本项目旨在为 Python 开发者提供可视化、一键式的打包体验,解决命令行参数复杂、环境配置繁琐等痛点。本次发布带来了完整的 GUI 打包流程、实时进度反馈及完善的跨版本编译器适配支持。
✨ 核心特性
- 可视化打包配置
多模式支持:支持单文件 (--onefile)、单目录 (--standalone)、模块 (--module) 三种打包模式。
插件管理:内置 tk-inter、PySide6、PyQt5/6、UPX 等常用 Nuitka 插件,支持复选框自由组合,自动处理大小写敏感问题。
数据与模块控制:可视化添加数据目录/文件、包含指定包/模块、排除导入项。
Windows 元数据编辑:支持设置公司名、产品名、文件/产品版本、描述及版权信息,内置版本号格式自动校验与清洗功能。 - 流畅的交互体验
非阻塞并发:打包、下载、环境检查均在后台线程执行,通过 Qt 信号槽回传日志,确保界面始终响应不卡顿。
阶段式进度条:实时解析 Nuitka 输出流,按“下载→编译→链接→产物”阶段动态显示进度百分比。
主题切换:支持亮色/暗色主题一键切换,用户偏好自动保存。
配置持久化:所有设置自动保存至 ~/.nuitka_gui/config.json,支持随时加载历史配置。 - 智能环境检测
自动诊断:启动时或手动触发检测 Python、Nuitka 及 C 编译器(MSVC / MinGW64)状态。
修复建议:针对缺失依赖提供明确的安装指引;Python 3.13+ 环境下自动识别并引导安装 MSVC Build Tools,避免误用 MinGW64。
🛠️ 技术栈与兼容性
GUI 框架:PySide6
Python 版本:3.10+(已在 3.13.7 验证)
编译器适配:
Python ≤3.12:支持 MinGW64(首次打包自动下载)
Python ≥3.13:仅支持 MSVC(需安装 Microsoft C++ Build Tools)