# PyPackager

**Repository Path**: yangxiaoyude/py-packager

## Basic Information

- **Project Name**: PyPackager
- **Description**: 简单好看的python代码打包工具 适合给新手使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img src="static/icon.png" alt="PyPackager Pro Logo" width="120" height="120">

# PyPackager Pro

### 🚀 专业的 Python 应用构建工具

[![Electron](https://img.shields.io/badge/Electron-Latest-47848F?style=for-the-badge&logo=electron&logoColor=white)](https://www.electronjs.org/)
[![Python](https://img.shields.io/badge/Python-3.7+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
[![PyInstaller](https://img.shields.io/badge/PyInstaller-6.0+-00ADD8?style=for-the-badge)](https://www.pyinstaller.org/)
[![Gitee](https://img.shields.io/badge/Gitee-仓库-C71D23?style=for-the-badge&logo=gitee&logoColor=white)](https://gitee.com/yangxiaoyude/py-packager)

**一键将 Python 项目打包成独立可执行文件**

[功能特性](#-功能特性) • [快速开始](#-快速开始) • [使用指南](#-使用指南) • [截图展示](#-截图展示)

</div>

---

## ✨ 功能特性

<div align="center">

| 功能 | 描述 |
|:---:|:---|
| 🎯 **简单易用** | 直观的图形界面，无需命令行操作 |
| 📦 **智能打包** | 支持单文件和文件夹项目打包 |
| 🎨 **图标定制** | 支持 PNG/JPG/ICO 格式，自动转换 |
| 📊 **实时进度** | 构建过程实时显示，日志可视化 |
| 📜 **打包历史** | 自动记录打包历史，快速访问 |
| 🔍 **环境检测** | 一键检测 Python 和 PyInstaller 环境 |
| 🌓 **暗色模式** | 支持系统主题自动切换 |
| 💾 **路径记忆** | 自动保存上次使用的输出路径 |

</div>

---

## 📸 截图展示

<div align="center">

### 主界面
<img src="static/image.png" alt="主界面" width="600">

*简洁优雅的主界面设计*

---

### 打包历史
<img src="static/image copy.png" alt="打包历史" width="600">

*展示过往打包历史*

</div>

---

## 🚀 快速开始

### 环境要求

- **Node.js** 16.0 或更高版本
- **Python** 3.7 或更高版本
- **PyInstaller** 6.0 或更高版本

### 安装依赖

```bash
# 克隆项目
git clone https://gitee.com/yangxiaoyude/py-packager.git
cd py-packager

# 安装 Node.js 依赖
npm install

# 安装 Python 依赖
pip install pyinstaller
```

### 运行应用

```bash
# 开发模式
npm start

# 或使用
npm run dev
```

### 打包应用

```bash
# 打包为当前平台的可执行文件
npm run build

# Windows
npm run build:win

# macOS
npm run build:mac

# Linux
npm run build:linux
```

打包后的文件将在 `dist` 目录中。

---

## 📖 使用指南

### 1️⃣ 选择源代码

<div align="center">

点击 **单个文件** 或 **项目目录** 按钮，选择要打包的 Python 项目

</div>

### 2️⃣ 配置选项

- **输出目标**：选择打包后文件的输出位置
- **品牌图标**：上传应用图标（支持 PNG/JPG/ICO）
- **单文件打包**：将所有资源打包成单个可执行文件
- **调试终端**：运行时显示控制台窗口
- **自定义名称**：设置可执行文件的名称

### 3️⃣ 开始构建

点击 **立刻执行编译流水线** 按钮，等待构建完成

### 4️⃣ 查看结果

构建完成后会弹出成功提示，点击 **查看生成文件** 即可打开输出目录

---

## 🛠️ 技术栈

<div align="center">

| 技术 | 用途 |
|:---:|:---|
| **Electron** | 跨平台桌面应用框架 |
| **Node.js** | 后端运行环境 |
| **PyInstaller** | Python 打包工具 |
| **Tailwind CSS** | UI 样式框架 |
| **Lucide Icons** | 图标库 |

</div>

---

## 📁 项目结构

```
pypackager-pro/
├── static/              # 静态资源
│   ├── icon.png        # 应用图标
│   └── image*.png      # 截图
├── index.html          # 主界面
├── main.js             # Electron 主进程
├── preload.js          # 预加载脚本
├── renderer.js         # 渲染进程
├── help.html           # 帮助页面
├── package.json        # 项目配置
└── README.md           # 项目说明
```

---

## 🔧 高级功能

### 环境检测

点击右上角的 **活动图标** 按钮，查看：
- 系统信息
- Python 版本
- PyInstaller 版本
- 环境完成度

### 打包历史

点击右上角的 **历史图标** 按钮，查看：
- 历史打包记录
- 应用名称和图标
- 打包时间
- 快速打开输出目录

### 实时日志

构建过程中会显示进度弹窗，实时展示：
- 构建状态
- 详细日志输出
- 进度动画

---

## ⚠️ 注意事项

1. **跨平台限制**：PyInstaller 只能为当前运行的系统生成可执行文件
   - 在 Windows 上打包生成 `.exe`
   - 在 macOS 上打包生成 `.app` 或可执行文件
   - 在 Linux 上打包生成可执行文件

2. **图标格式**：
   - Windows 推荐使用 `.ico` 格式
   - macOS 推荐使用 `.icns` 格式
   - 其他格式会自动转换

3. **依赖处理**：
   - 确保 Python 项目的所有依赖都已安装
   - 复杂项目可能需要手动配置 PyInstaller 参数

---

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

## 📄 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

---

<div align="center">

### 💖 感谢使用 PyPackager Pro

**让 Python 应用打包变得简单而优雅**

Made with ❤️ by PyPackager Team

</div>