# 一键式环境部署

**Repository Path**: fiagainster/one-click-environment-setup

## Basic Information

- **Project Name**: 一键式环境部署
- **Description**: 利用Python实现的一个简单的一键式环境部署脚本，自带各个环境的安装包
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-24
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 一键式环境部署工具

## 功能说明
- **多环境支持**：支持20+种常见编程环境的离线部署
- **直观图形界面**：卡片式布局，支持窗口大小自适应，操作简单友好
- **智能环境检测**：自动检测系统中已安装的环境，避免重复安装
- **一键部署**：自动执行安装和环境变量配置，无需手动操作
- **推荐配置**：按开发场景提供推荐的环境组合，方便快速搭建开发环境
- **详细日志记录**：全程记录部署过程和结果，便于排查问题
- **跨平台兼容**：支持Windows和Unix系统

## 目录结构
```
一键式环境部署/
├── main.py              # 主脚本，包含图形界面和核心逻辑
├── utils/               # 工具函数目录
│   ├── __init__.py
│   ├── detector.py      # 环境检测模块，检测系统中已安装的环境
│   ├── installer.py     # 安装模块，执行安装包的安装
│   ├── env_config.py    # 环境变量配置模块，配置系统环境变量
│   └── logger.py        # 日志模块，记录部署过程和结果
├── packages/            # 安装包存放目录
│   ├── nodejs/          # Node.js安装包
│   ├── python/          # Python安装包
│   ├── git/             # Git安装包
│   ├── vscode/          # VS Code安装包
│   ├── java/            # Java JDK安装包
│   ├── mysql/           # MySQL安装包
│   ├── ruby/            # Ruby安装包
│   ├── php/             # PHP安装包
│   ├── go/              # Go安装包
│   ├── rust/            # Rust安装包
│   ├── dotnet/          # .NET Core安装包
│   ├── mongodb/         # MongoDB安装包
│   ├── postgresql/      # PostgreSQL安装包
│   ├── redis/           # Redis安装包
│   ├── cpp/             # C/C++安装包
│   ├── flutter/         # Flutter安装包
│   ├── dart/            # Dart安装包
│   ├── androidstudio/   # Android Studio安装包
│   ├── apache/          # Apache安装包
│   ├── nginx/           # Nginx安装包
│   ├── docker/          # Docker安装包
│   └── kubernetes/      # Kubernetes安装包
├── config/              # 配置文件目录
│   ├── settings.json    # 全局配置
│   └── env_templates/   # 环境配置模板
└── logs/                # 日志文件目录
```

## 使用方法
1. **准备安装包**：将对应环境的安装包下载到 `packages/` 目录下的对应子目录
2. **运行脚本**：以管理员权限运行 `main.py` 脚本
3. **检测环境**：点击"检测已安装环境"按钮，查看系统中已安装的环境
4. **选择环境**：在图形界面中勾选需要配置的环境，或在"推荐配置"标签页中选择开发场景
5. **选择安装目录**：点击"开始部署"按钮后，在弹出的对话框中选择安装目录
6. **等待部署**：系统自动执行安装和环境变量配置，无需人工干预
7. **完成部署**：部署完成后，系统会提示重启电脑以确保环境变量生效

## 支持的环境

### 基础开发环境
- Node.js
- Python
- Git
- VS Code

### 后端开发环境
- Java JDK
- PHP
- Go
- .NET Core
- Ruby
- Rust

### 数据库
- MySQL
- MongoDB
- PostgreSQL
- Redis

### 移动开发
- Flutter
- Dart
- Android Studio

### Web服务器
- Apache
- Nginx

### 其他
- C/C++
- Docker
- Kubernetes

### 数据科学
- Anaconda
- R语言

## 推荐配置场景
- **安卓应用开发**：Java JDK、Android Studio
- **数据分析**：Python
- **数据科学开发**：Python、Anaconda、R语言、Git、VS Code
- **网站开发**：Node.js、PHP、MySQL、Apache、Nginx
- **前端开发**：Node.js
- **后端开发**：Node.js、Python、PHP、Java JDK、Go、MySQL、PostgreSQL
- **移动应用开发**：Flutter、Dart、Java JDK
- **桌面应用开发**：Python、C/C++
- **游戏开发**：C/C++、Python
- **人工智能**：Python
- **DevOps**：Git、Docker、Kubernetes

## 技术特点
- **模块化设计**：各功能模块职责清晰，易于扩展
- **响应式界面**：卡片式布局，支持窗口大小自适应
- **多线程处理**：使用线程避免UI阻塞，提升用户体验
- **智能路径检测**：自动检测安装路径是否正确
- **安全的环境变量配置**：使用PowerShell（Windows）或修改shell配置文件（Unix）
- **详细的错误处理**：捕获并记录所有可能的错误

## 注意事项
- **管理员权限**：请以管理员权限运行脚本，否则可能无法配置环境变量
- **安装包准备**：确保安装包已下载到对应目录，且格式正确（支持exe、msi、zip、tar.gz）
- **安装过程**：安装过程中请不要关闭窗口，以免影响安装结果
- **环境变量生效**：部署完成后建议重启电脑，确保环境变量完全生效
- **安装目录选择**：选择合适的安装目录，确保有足够的磁盘空间
- **网络环境**：本工具支持离线部署，无需网络连接
- **日志查看**：部署过程中的详细信息会记录在 `logs/` 目录下的日志文件中

## 常见问题
- **安装失败**：检查安装包是否完整，安装目录是否有写入权限
- **环境变量配置失败**：确保以管理员权限运行脚本
- **检测不到已安装的环境**：可能是环境变量未生效，尝试重启电脑后再检测
- **安装包格式不支持**：目前支持exe、msi、zip、tar.gz格式的安装包

## 后续计划
- 添加安装包自动下载功能
- 增加环境版本选择功能
- 添加环境卸载功能
- 增加配置备份与恢复功能
- 优化错误处理和用户提示