# git_gui_uploader

**Repository Path**: nelson_Q/git_gui_uploader

## Basic Information

- **Project Name**: git_gui_uploader
- **Description**: 为了帮助初学者更轻松地掌握 Gitee 代码上传的命令操作，我们可以设计一个简易的 Gitee 上传辅助工具，通过图形界面（GUI）引导用户完成操作，并实时显示对应的 Git 命令，让初学者 “边用边学”。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Git, gitt图形化上传软件

## README

# Git初学者图形化上传工具

## 项目规划

### 项目概述
- **项目名称**：Git初学者图形化上传工具
- **目标用户**：Git初学者
- **核心价值**：简化Git操作流程，提供直观的图形界面，无需手动输入Git命令
- **开发周期**：14天 (2025/10/27 - 2025/11/09)

### 功能规划
1. **项目路径选择**：提供文件浏览器选择本地项目
2. **远程仓库配置**：添加/修改/删除远程仓库URL
3. **分支管理**：查看、创建、切换分支
4. **文件暂存**：选择需要提交的文件
5. **提交管理**：填写提交信息并执行提交
6. **推送功能**：将本地提交推送到远程仓库
7. **提交历史查看**：显示项目的提交历史记录
8. **错误处理**：提供友好的错误提示与解决方案建议
9. **操作引导**：提供步骤指引和帮助文档

### 技术选型
- **开发语言**：Python 3.8+
- **GUI框架**：PyQt5 (跨平台支持)
- **Git操作库**：GitPython
- **构建工具**：PyInstaller (用于打包跨平台可执行文件)

## 实施方案

### 开发环境准备
- 安装Python 3.8+
- 安装PyQt5、GitPython等依赖
- 确保系统已安装Git命令行工具

### 架构设计
- **核心层**：处理Git操作逻辑
- **UI层**：用户界面展示和交互
- **工具层**：提供辅助功能和配置管理

### 实现步骤
1. **环境搭建与依赖安装**
2. **基础Git操作功能实现**
3. **用户界面开发**
4. **功能整合与测试**
5. **打包与发布**

## 进度记录

### 2025/10/27
- ✅ 创建项目目录结构
- ✅ 编写项目README文档
- ✅ 设计应用架构
- ✅ 实现Git操作核心功能 (git_manager.py)
- ✅ 实现错误处理模块 (error_handler.py)
- ✅ 开发用户界面 (main_window.py)
- ✅ 创建配置管理模块 (config_manager.py)
- ✅ 创建文件工具模块 (file_utils.py)
- ✅ 编写应用主入口文件 (main.py)

### 待完成任务
- ✅ 安装项目依赖
- [ ] 编写测试用例
- ✅ 打包应用程序
- ✅ 修复程序运行中的错误（如Git未找到错误） - 2025-10-27
  - 添加环境变量设置，防止GitPython导入时抛出异常
  - 确保在动态导入Git模块前设置正确的环境变量
  - 优化Git检测逻辑，在Windows上使用shell=True提高兼容性
  - 添加对D盘Git安装路径的检查，确保能正确识别非默认路径的Git
  - 更新PyInstaller配置，添加必要的隐藏导入和环境变量设置

## 运行指南

### 方式一：直接运行可执行文件（推荐用于普通用户）

1. 进入 `d:\py\git_gui_uploader\dist` 目录
2. 双击运行 `GitGUIUploader.exe` 即可启动应用程序
3. 确保您的系统已安装 Git 命令行工具

### 方式二：从源代码运行（适用于开发者）

#### 环境要求
- Python 3.8 或更高版本
- Git 命令行工具

#### 安装依赖
```bash
cd d:\py\git_gui_uploader
pip install -r requirements.txt
```

#### 运行应用程序
```bash
python main.py
```

### 使用说明
1. 在"仓库管理"选项卡中选择项目路径
2. 初始化或打开Git仓库
3. 配置远程仓库URL
4. 在"提交推送"选项卡中暂存文件并提交
5. 点击"推送到远程"完成上传