# 一键配置环境变量

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

## Basic Information

- **Project Name**: 一键配置环境变量
- **Description**: 一键配置主流环境变量
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="src/一键环境配置.png" alt="EnvPilot Logo" width="128" height="128">
</p>

<h1 align="center">EnvPilot - 环境领航员</h1>

<p align="center">
  <strong>跨平台环境变量一键配置与管理工具</strong>
</p>

<p align="center">
  <a href="#核心功能">核心功能</a> •
  <a href="#快速开始">快速开始</a> •
  <a href="#问题与反馈">问题与反馈</a> •
  <a href="#技术栈">技术栈</a> •
  <a href="#许可证">许可证</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/version-2.2.0-blue.svg" alt="Version">
  <img src="https://img.shields.io/badge/platform-Windows%20%7C%20Linux-green.svg" alt="Platform">
  <img src="https://img.shields.io/badge/license-MIT-orange.svg" alt="License">
  <img src="https://img.shields.io/badge/rust-1.70%2B-orange.svg" alt="Rust">
</p>

---

## 项目简介

**EnvPilot** 是一款基于 Rust 开发的跨平台环境变量管理工具，支持 **Windows** 和 **Linux** 系统。专为开发者设计，一键配置 Java、Python、Node.js、Go、Rust、MySQL、Tomcat 等开发环境，彻底解决环境变量配置繁琐、易出错的问题。

> 🎯 **核心问题已修复**：解决了"添加不生效"、"删除删不掉"、"PATH 清理失效"等历史遗留问题。

---

## 核心功能

### 🚀 环境变量管理
- **新增/编辑/删除** 环境变量，支持用户级和系统级配置
- **即时生效**：Windows 广播 `WM_SETTINGCHANGE` 消息，Linux 提供 `source` 命令提示
- **强制校验**：操作后自动验证变量是否真正生效

### 🧹 PATH 路径管理
- **精准清理**：路径前缀匹配 + 大小写不敏感，避免误删/漏删
- **自动去重**：PATH 路径自动去重，保持环境整洁
- **可视化显示**：清晰展示 PATH 中的相关路径

### 💾 备份与回滚
- **自动备份**：每次操作前自动创建备份
- **一键回滚**：支持恢复到任意历史备份点
- **操作日志**：完整记录所有操作历史

### 🔐 权限与安全
- **权限校验**：操作前检查管理员/root 权限
- **路径验证**：检查核心可执行文件是否存在
- **错误提示**：清晰的 GUI 错误弹窗提示

### 🖥️ 支持的开发环境

| 语言/工具 | 环境变量 | PATH 配置 |
|-----------|----------|-----------|
| Java | `JAVA_HOME` | `bin` 目录 |
| Python | `PYTHON_HOME` | `Scripts` 目录 |
| Node.js | `NODE_HOME` | `bin` 目录 |
| Go | `GOROOT`, `GOPATH` | `bin` 目录 |
| Rust | `RUST_HOME` | `bin` 目录 |
| MySQL | `MYSQL_HOME` | `bin` 目录 |
| Tomcat | `CATALINA_HOME` | `bin` 目录 |

---

## 快速开始

### 下载安装

#### Windows
1. 从 [Releases](https://gitee.com/yibeigen/one-click-environment-setup/releases) 下载最新的 `EnvPilot.exe`
2. 双击运行即可（无需安装）

#### Linux
```bash
# 从源码编译
git clone https://gitee.com/yibeigen/one-click-environment-setup.git
cd one-click-environment-setup
cargo build --release
./target/release/env-config-gui
```

### 基础使用

#### Windows 平台
1. **配置环境**：选择语言 → 输入安装路径 → 点击"保存配置"
2. **测试配置**：点击"测试配置"按钮验证是否配置成功
3. **清除配置**：进入"清除"页面，选择要清除的环境变量

#### Linux 平台
1. **配置环境**：选择语言 → 输入安装路径 → 点击"保存配置"
2. **生效提示**：配置完成后执行提示的 `source` 命令使配置生效
3. **测试验证**：点击"测试配置"验证环境是否正确

### 从源码构建

```bash
# 克隆仓库
git clone https://gitee.com/yibeigen/one-click-environment-setup.git
cd one-click-environment-setup

# 安装 Rust（如未安装）
# Windows: 下载并运行 https://rustup.rs
# Linux: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 构建
cargo build --release

# 运行
./target/release/EnvPilot  # Windows
./target/release/env-config-gui  # Linux
```

---

## 问题与反馈

### 常见问题

#### Q: 添加环境变量后不生效？
**A:** EnvPilot v2.2.0 已修复此问题：
- **Windows**：自动广播 `WM_SETTINGCHANGE` 消息，新开的终端窗口可立即获取变量
- **Linux**：执行提示的 `source ~/.bashrc` 或 `source ~/.zshrc` 命令

#### Q: 删除环境变量后仍然存在？
**A:** EnvPilot v2.2.0 已修复此问题：
- 删除后自动校验变量是否真正移除
- Linux 支持正则匹配各种 `export` 格式（带空格、注释、单双引号）

#### Q: PATH 清理不干净或误删？
**A:** EnvPilot v2.2.0 已修复此问题：
- 使用路径前缀精准匹配
- 大小写不敏感比较
- 清理前自动去重

#### Q: 提示权限不足？
**A:**
- **Windows**：右键"以管理员身份运行"
- **Linux**：使用 `sudo` 运行或配置用户级环境变量

### 反馈渠道
- **Gitee Issues**: [提交问题](https://gitee.com/yibeigen/one-click-environment-setup/issues)
- **功能建议**: 欢迎提交 Issue 或 Pull Request

---

## 技术栈

| 技术 | 说明 |
|------|------|
| **Rust** | 系统级编程语言，安全高效 |
| **eframe/egui** | 跨平台即时模式 GUI 框架 |
| **winreg** | Windows 注册表操作 |
| **winapi** | Windows API 调用 |
| **regex** | 正则表达式匹配（Linux 配置文件解析） |

### 架构特点
- **跨平台设计**：通过条件编译实现 Windows/Linux 双平台支持
- **即时生效机制**：Windows 广播消息 + Linux 临时变量设置
- **安全校验**：操作前后双重验证，确保数据一致性

---

## 更新日志

### v2.2.0 (2026-03-10)
- ✅ 修复"添加不生效"问题：Windows 广播 WM_SETTINGCHANGE
- ✅ 修复"删除删不掉"问题：删除后强制校验 + 正则匹配优化
- ✅ 修复 PATH 清理失效：精准匹配 + 大小写不敏感 + 去重
- ✅ 新增"日志"标签页：操作日志 + 备份历史
- ✅ 新增备份与回滚功能
- ✅ 新增权限校验与错误提示
- ✅ 优化测试配置：成功后自动更新状态，显示路径信息
- ✅ 优化 exe 图标：多尺寸高清图标

---

## 贡献指南

欢迎参与项目开发！

1. Fork 本仓库
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

---

## 许可证

本项目基于 [MIT License](LICENSE) 开源协议发布。

```
Copyright (c) 2026 艺杯羹

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
```

---

<p align="center">
  Made with ❤️ by <a href="https://gitee.com/yibeigen">艺杯羹</a>
</p>